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Thr& papsr describes LLOGO, ^n implemen1*tiQn dI IKb LOGO linguigB wrilten m MACLISP 
1^1 I he IT&j TEN&O and TENEX PDP-10 t^rlemE, and h*JLTJCE. The rel^tp^B merits of LOGO ar«J L[5P 
as edtKational laneuaeei we diFci^s^d. Df?ign decispons in IHb LtSP imptftmcnlatnOn of LOGO *r8 
COM r« ted with tho^e oi 1w(j alho" irnpierrantalionii: CLDGO (or (he PDP-10 and niOCW for I he 
PDP-1 I, bolh writlepi in asrEmbler JineuSfifl. LLOCiO's special iadljIJEi faf eh?rjicf&F-oriEfl|ed display 
lerminah, gpaphu: display "turllvs.", and imKk aenjr'alJOiT are aiiD described. 

This wort, vtn^ suppoTtKl m p^rl; by the Nation jil SciBnEC FDundiliors under erant dumber 
GJ-JD49 ^nd CDiduLteiJ st Ihe Arlilidal [nltlhgence Labor «! pry, a MaiSBchySfrtts IrKthtuI* iff 
Tfl^hfiolosy research p-rnsfflrtL fleprcd-ucl iOn Of tNs dotumen-l in whobe Or in pari i& permined (or 
»riv ptJfpciM ol the United 3la(es C^svammertt. 
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Section L Vfhj iTnpHtmcnt LOGO in LLSP 



LISP h;., prove-d its«l| fe be » [>d*c'FuI lan^uw fer rEpretentinE i:Omple« infor mst.orv 
proceiiing lasks. Thh^ p&war ilems i<'flrn: 

J. Tba unifcjrftv ropreiEntatiqri o\ programs trid datii. 

2. The ability to buil?l »rbiJrarily ttwnplor data Btructuftfs in (he lorm 9f s-oicprHssiEwis. 

Po*tr, however,, i$ nol fiecEssaTily gflod pedaeq^s^. LOOO is a eompuler ljjnfiLi*ep do^igned 
especially for [he beafni^er', Jb purpase i$ to inkoduce the iundamental id«,s. d compulatifln *s 
cled-rFy as posihble. 

LI5P 10(30 i? an invplerrienfaliofi ol LOGO -n L[SP. Jt has b&*n deiisna-d for seve#*l r«»E«ns. 
The first H Ihal thEse t*0 languages jhjr* a fundar»nt*l c?fr* in commQPL Bo1h are linei »h»r«(|, 
interpretive Ishguajei capabk of iull recuTiion, Variable and procedurB nanei may fet any ^thrift gf 
letter^ and digits, Sub -procedure (^f.nirians are indepcnstent o^ super-pr(H;gdure&. Both tiijniE^rical 
ard li.sl -structured informiiliOfl can be m^rupulaled wUJi eou^l iMility. Thus, the LOGO sysleins 
programmer is freed d ths r'et^saity o( re de^^elopira vsrjaut 1»Lilitisr: ,il ready svailabte In LlSP 
Jlitis, recursion, garbage co^lf^cM^n. grrcr service rr^ip?, jr^ferrupli). * c*n conceflltal*: &n 3iddrlior»s 
(hettfth error analysrs) and modiUcaticni (podagOgicat iiftiplifi^.jtion&) to LI^P. 1,L0G0 uniliE? larvfiuafls 
development acr-Q^s a broad spectrum rar^jiris If cm PLANt^£R a'vd C0NI\l1V£ff IhrOtiBh LtSP to lOSa 

A sezmd reasori for thi-s impl*rr*nUtiOfl il ta prOvlcSe a nalural IrjHsitiOn t& !tie mpre 
powerful cornputatitina! *orld ftf LISP as tht studenl grows Mffr s6ph«1icaled. Whtn desired. I he 
studErnt has access to all of the c*p»bilili« of LISP intiudinE: 

Arrays 

Functions ol ar-bitriry numfcar cf inputs 

Func lions that do not eu-aiuate their irvuk 

WfCRO-PLANNER a^gl CSDr#l[VER 

tnterrupia 

L[$P compiler 

Property lists 

Floalinj; pfljnl numbers 

CliarHler display cursPr manipuljltiiort 

IflliTiite precision fureid point aiithrnttlt 
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SiFctiDti ?. D iff erencf.^tvelwetn LOCO And LISP 



The dif lerence? between LOGO «ri{j LiSP ^«n be ctef cnbed «n tKft biih «f khree «duc^ Lionfll 

Si'Hvp.licrty o« bolhi I ha cemputiMOrts* and fisp^3^^atD^y kind 

NBluraln&&s i^htsrein thp Dverhtad far a naiva u-ser is (Tiiniipited by (flilcMrins standard English 

-CQnventtorvs. 

Di^pgrjty whith eiiqilli«iies l:he disMnctiOn bolween vSriowS mO^S *Uth as defining ver-sus 

running prflgraiw, 

It ^hotrtd b* fiQted, however, Ihat I here cam be f^J one unlflue solution to tJTe *bB5t" 
educational langtiagei These Ihrf^j eO^M t*n cdnflitl. Furlhermore, they tannOl bp ?C3 rmphifiired 
thai impflrtsnf \dtMt of tomput-aliicHi are comiplelBly elimin^lcd Irom tli*- language. For 5tuder»ts &( 
differerl backgrouod^f simpl icily and ftatui"*!"*?* may have very diflereiit meamne^. HflfW*, 
aller-nalives 1o the parNculaf chfrices rtiiid* in tJctigniina CLCGO and 1 [LOGO are also described. Thij 
aecliori inay be viewed 4$ prrtenling a ^gectruni dI pAfsibilites frDm whkh « td^chi^r can build b 
computpliort^l w^qrld tailcred lo bit 6wn pe-d^igogtcal pvpOs«$, 

2^1 Simplijcity 

Ltsis versus Beritence* 

y&ts hnvc > iiAxpk recursive delinitidn, A list is cilh^r 

1. Nil, the empty 1i*|- 

2. (wordit *ord2 ,.,},* Bequertce of words (■ aloms) 

3. A list Dl li&ls. 

TbiJi di?liiiiti&n is confusifig when Ihe Btucfent Is slill t-iw<f\f, trouble *ith the eorKepI Q-f reci/Tsi?", 
CLQGO limils Uself 10 lists^ built frojn only Itw firs! two of these 1hree cl^uees. Sucb lisl*. are called 

Allernalive vif'v: tht concept pi recursHin is toa impOrtanl! lo tie- elimlnitfrd frwd LOGQp 
Recursive progr^int? »r« Allayed- Edueatic»naAly, Ihe mare eKarnple-s of fSCUfStgn av>ilable^ 
the- ^jt-^ier it i^ to une(er&t arid. Hence, lisEs should be ahoweij. 

CcirtvpiJlaEional power is not i*l-iV?iys m cOnflicI wIlTi edgt*tiofl*l simplicety. In addilitin 10 tbe 
Elafidard lisl Operation^ of FIRST iLAR) and BtrtfiHSf ECDR), LOGO provlAjs LAf!T and 
BL'Tl./lST. Furthermore^ all four o1 these opsriilieins work on wordi a well as sentences. The f*tt 
that w&rd manipulation i^ moi"* cottty than 11 si manipulation for LtSl^K Or thai IsHiiifi the T^AST of a' 
li^l is wore expensive than cOmpuling, Us URST Is not of interest 1o Iha beginner, TNc natura/l 
symmelry of ti^vmg alL of these cperalions is IP tie preferred. 

Allerrtalive viflUr: LOOO ifiNodiiJces two data lypes - words and tenlentt$- There is both 
4tn imply word and an empty sentence LISP'S world i-s eaiier lo undersland. Thwro is 
only one lype ot data, s-e-^ pwes^iona. Prrmilives like C/JR are list opeiatiOns On-ly; (hey do 
nol Opcratt' on words by rmaFiipulal ing Ihe wOrd"^ prinl nanifl, as LOGO'? F)fiST does. 



Repealedl/ IH.jTf''lKSrir% b sSntsFvce m LPGO fliwaj's terwin*|« In the empty l«&t, tn LISP, 
Wfith ih m&rp general }\s\ ilrsiclure buiN iron ~tfQi^^ psirs" and CfJA'Sing, Ihrs is not il way's ip. The 
resull is the pgiS-ibM»ty 01 "shp-lhrOugh" bugi lor ElfPTTiP eP(3l^e^ti 9f r*euFsivB procedures. Thus, 
LOQO elirt^ilnate■s a comftiflfT jcur<-o ol error wrthemt tignilicanlly limitipfl CDm|&u1»tiflnsl power. 

AJfernalive view: flllo*mg an alOn to he Ihe LDR of an i-espreisian someti^mes ^liows tcf 
econqmy of slorage. Al-so. Ihe tymmetry ol C^fl arj CftR m U-SP ruafc? I he data slruclurB 
c*5iifr to eifpijin, ailhouahi \hey art syitimetric i* Jift OpBraUOns ONy for Ihe particular 

repreientaliprtpF jitt*. uS^d ^n Ll^P. 

Rigi^ prfljrimi forW 

LESP ailDWi pro^rdftv? fp b* lisls of any formu Editing and deh-ugg'ng coniequftntiy becffme 
awltwifarcl tJuc to- thg difficulty m r»BTi(*ing paTJ'fi aF I'he pro^r^m. LOGO iimplifips prograrn tlructure by 
roquirir*E Ihal * p^oaram b* a itfu-i. a\ numbered li™*. ths kjcBliorts o( bugs artd inliendtrf e#iti 
are then fst e*siei t5 dss-tiribe. 

Criticlsirt; L030 violales 1his as^uiYiptiun bjr aHowing 1he i^itu Iq ei-^iife Imc^ of unlimiled 
tOTnpieifily. Jt (vould be preFei'sti* to lirtiif a lirre lo s single lap level caJi. Thii does, nol 
prohibil iieiiimE. ■ ^gnd^mcnlal idea ii cO*nputa1ion. But 11 doet prohibrl ctel*dlirie lht 
♦fitir* pOml o1 line rumberi wilh ^tsth tade as: 

An allernative sthftmt hniahj tw ^o adop^ b TJOT" lilia tbnvBntion. Une-s are idenlified 
l.jy flU^-ots (rOm user -defined focai'ion s/mhols. This has tht a*f*flt^|;fr ol cncOuT^g^n^ I ho 
u&e ot mnernoniic name? I^r pohtiont of fhe user's pfdgram,, rather th«i line mjmbers, 
whith have r*0 rnncmoni^ value, whiis ralaining the virtue oF having a name For tvtty p-(r| 
el the program. The uis' v^Duld nol h^ve Fa r«hLi[^l>^r lin^ ii ht; wanted to ins-arl more 
Mjies Iwlwetn |wo lirx»5 OF cOde [fwn lt» diPferen^e belween their line niwhers. 

Inleger fljitlimelic 

The initial CLQGO world Nmita fhe u&er fp inteet-r jrithmetk. Th« r^fionale behmd this is lo 
avoid the compleirity qf ietli^H fractions. This is dearly a sirpjjhFicalien whose value depends on Ihe 
biaclK£raund qI Th« students. 

Cril'ki^rtt; »VBh for glgmenlai'y school chUdren^ Ihis simpliFkaliDn may eausB confusinn. 
MosI beginners are Iroubled with 
I 

-- -0 
Z 

Propp-nenfs of finetf polnl ariithmslie ml|.ht rsply thai Ihi^k no werse IhaR 
1 

— - .59999^ 
I 

However, 9 defi:mal prinler can be clever in per Formi nj round&fl. 

Other alternalivBS are lo limit Brilhmeti^ lo rational numbers, or Td use the fg^lowiri} 
LISP cOn'VBnIiCini MumbBrs are fixed p>Oint ur^less ending in b decimal If action. Operatian» 
Qflly retot'11 'ik«I point if both opcrindt it» liintd point, 
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Another virluE of LI?P is Ihal fixed pfiint numfcEri can ba mlini(e1y la*fP. Arbilrary 
limit jiticin<5 due tc> thw finite iize o^f the (OrDp^ter^ fne\-4 (Ho not tKi£t 1« cortFus» Iht begitvier. 

Conditianala 

l-OGQ iillowi th? FollDWjng lype oF tiranching: 

TfiST -sela a Fla(; which subsequenl fFTHi/K'^ -and fFF/II^fTs acces-s. This avoids Ihs necessity ol 
IPk efilire ccnd-ilion^^ ftppcdf ir^g on t ^ingif tins' isf li^e procedure. Tht ttud&nl hag. explicil name^ in 
(h* form flF line nymbor^ '<ir e^ch branch, 

Critkism: This prevents nesting <!* ccindiliOnals. A fsci&nd cOndiliCma) wipes 4ut (he resiitts 
jjf Ihir fii'sl, Also, |h« swpe gF iW. FUg $et l>y * TKST m Mhtlt*r, [n LLOGO^ Ihi5 l<*e is a 
L[SP usriablej IckJ Fft the procedure in which Ihe TUiTOccwt. 

tOQO^^ l«(^h >q( c^iwed tcicifit $ucF^ m f)0 stvi MAPC^R an tse criticiied £& encouraging bad 
pre^ramming pr«iclic«, ^urh m eycessive us* <?f CO. This eb^cyr^?? Ihc lupjc^i! sUutturp of prOErami, 
Ako, it may b& i^iQi^iFiiantFy <ohFiJE:>ng ta the beginn^f^ ^nd 1he mum cF many bugs. A child might 
undBrttand quite weII a cnntrol ^Iructure cortcspE like "tio Ihis. pari d1 the progrann LhrEe limE-s", &r 
"do this pari •ot Ihe prngran (fir Each Elerrwnl *t the hsl", bul ^nay be unable t& Open-cfldc thit 
IjQritrfll ptruclurt^ in learns frf jijmp;^ ?.n^J ^OncJiliOnil?, LOGO pr'Opr^tn^ f^rt'f b* "pt*1ty pflifiled'' lo 
revEal their logicall -structure as can prdgrsn^ wnilten in LLSP af a black ^IfucFured language. 

2-? Naiuraliicss 

Mnenhonic Ma met 

An nbvipus virtue oF any cOnnpuler languags is 14 ike prficsdurs names wh&?e EnglKh 
Winning suEge^ts Iheir purpose. ConscquiriFly, LlSP's pnmilivr^ f,/lF *rtd CDR mt *tf\*m^ FfHST 
«nd m'TFfRST, 

rtole: Everyflne remBri*berE btfvt un-inremOnic CAR and CDR ^t. Howcvtr, tnMt LISP 
primitives- are rvatned alter their Eng.liah cfiunlerpart^. 

CLOGO synla^ allow? Ihp i»o tH i;crtain ""nOiw wOrrfa', wflrrfs iwhkh *ti|Sfr*t irt 111* user's 
cedB, bul havE no eFtBcl beyond matsng Ihe rorfa nead riKKe like English ■sentences. Fftr exsmpl*, Ifr 
Ihfr fflltowinu liri«( Qi LOGO tiKte, the /liV(J, Ofi, ntFrfi, tnii TO »re p*rmit1*d but terue no 
comput*(ion*l purpo'^e. They do nol ditijriste procedureip «t is Ihe usuil cise with wp^rda r*ot 
b«eirtnine with » to\on. 

tlTftFK "--yft-diftHf ;> OH "^pnniit^ie 2> 
GGTii 

HOwpvrr, a? the sludt^TnE E^sns mOrc injighl irltfl LOGO, "Oi!^ wQrdr; tE.q&me fl burderi. Thay 
cOmp-licalB Ihe lask ot Ihe parser, preventing (he student FrO^rv Feeli-ng thai he rciaHy imdrrslands. th« 
language. -Most oi the noiie words have been elimineled in both lltOOO ajnd L15P LDK3. [LLOGO ^wll^ 
lolerat& Tttl^N m f:.onii\i\Qr\»\i, and TO in tfanislers, howev^er, because they are s^ commonfy us«d.] 



Wakhins ErgfiTh vcKj^bufary ta Ksmpuler funetienfi cm be dMficulL Enalish ^^Jrdi rfrely 
ri.Bve a £.r^tQ rne^nina- FoUowiriE sre sCmw Example* *lT«fe CLOGO may ha^* m,de She wrong choice 

I- CLOGQ iJie? fi insleid ^i fc^pE/jl/. lor its equality prechjle. Tbfr t^VKn^ts is |h«| /S will be F™er» 
famHiar fo a r»rt-m>lhB-fla[n:al b^^el^ner. However, the Qrtitvpre^ent nafurt fit Ihia Er-fthsb verb 
r«suH& in RUcK LOGO tode *t: * 

thu5j »l irtl:gh| be belter for LOGO iiy U5C i;(Ji|jVJf^ 

2. Armthtr Bicamp(e where LOGO m.y h^^.e thosen th, wrw* word i« m deFiflir^ procedures Thus is 
done via: 

TO PfiOCEfyVtiii.,\AitK fJiVP^Tj r/Wf/fS . . . 
The Enali-th word "to" ^^ imply e^etultOn.: For eirample. Tie i& lo run hi* prfiaram", A twHer chmee 

Parsing 

LISP avelds th* necessity of p?r;.ng throuflh fhe irb of p«r«>itP«Be£. This miBliI ba 
considered wetl '*orlh emulali,^ m LOGO (or lis e.pljinitary LMnpiicHy, However, simplicity must be 
contrasted with rvaturfltne^s. A b€^\r,ntf i? used 1d using En^lrah wher* ^.^rbs and modifiers are 
connecf^d by et^rnmar, canle^t *nd meaning rather fhan e^plitrt psTenlhesizmg. This nalufalneis 
can Iw preserved for prflcedures Ihii1 take a iWsd nymbcr Of inptits- This allows such hrWs d code 
TO be yndftrslOOd by anyflne wilhoul any tpecial proBramming knowledge, 

FOHlFAKli }m RKtfT M 

TTiiJi, * beEir*ner can espresB himseir ^ith nP entra bgrden of parerrthssiting whan his prfl^r^^s ore 

Parsing can be ustd 1o permit infix nolatiPn. Ajtin- it h smpler lo demand Ihat «1l 
f^ittCtiOnal tails bfr in prelin ne^t^jlion. Howe^ifr, 3 bejinner is i»r rnPre famrlt*r with yORFARD 
i5IDh*in (han with i:f ftWr^lflfl fSUif iStt}K JAM 

Ev^nluall/, is tn^'s code become* nrore comptexT parentheses becfiimB i siinpiifyinE tool 
One deet not h^vc to ^uess hqw Sh? parser wril xork, LLQGO allows Ihis. if defilr«d, parent hetet 
ire permitri?d and inlarprded iri Ihe itandirff -nay. 

Criticism: LOGO complltil^s itt parsing jlgoritNin In several wsy-i, making it difficult to 
enplain lo a student, For eKarnple. Ehp Pat^uaB,e cfQ«r; not insist that ^1! prinxiUves tah* 9 
fixed number «! mputs. In some cates suth «^ the title Imes ftF definiliont, (hig is 
reasonable. On the dhe^ hand, it ta somcivhjt corvfuaina to liwl such pritnilivps a? S^^iW to 
Only 2 inputs iF not parent he^iisd bul any nmnbiir Of inpuis if pirenHhesized. Fqujlly bad 
PS ttw fact that prjmitivei lik« LIUMO-e PRl?iTOUT for printing detinihorB d? not 
e^filuate thEir inputs It would h* more consistent J<5r 

PHismirt "I'lffjcff^ji" 

to hfr rp^uired. 
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^■3 Di'sparl jjf 

Bolh pi-qarflffls and dsU are inFor*Ti»licin strtKturt?. The dMFerchce belween lh(f two is 
Mtelv a mailer qf use LlSP p-res-erves this el^ftant viaw by ?Hnwing prOgi'SWS to be psssfrd a& inpul 
and ird#ed to even r^dtHne Iheir^Blyes, "Hhis. power, tt^i all Hb B'mp!iti1y, can confu^f the beg^nnrr. 
For the novice. Ihe^ ctilference beUflCn delining *-id running a pr^edure is urvclesr. LQQO prflvidei 
clflFificjtiOn by forcir-E a cOinpleSe di&tin^tiofl between Ihp pmces^BB &1 d.l.nlhe and Of ^valuation. 

Crpticism: LCKjO woflflles iY»s ides, A program <4n be executed miide a detitiiticin if not 
pretedcd by a tir* numtfrr. This it ji n^ttake. The typkal cate it Iflr the uter to h^ve 
intended lo typi- the line number. In its wi'stful desire tOr more computalional power. 
LD&O hJii forgnUcn itt epiEtennolog,it»« <ounda1iOm. 

hoinanymi 

U5P has the abilit/ Iflr « ward lA bo the nartw of bolh H ppocedure jjrtd a wariaiblr. The 
position of the word in a li^t then delermlnp*. haw i-t h used. Hofflonyms, hpwever, can b« cortfuiins, 
Htiw ntioiiid a word wKich is bolh ? pr-otedure and * VMiahle ba treated when it Is lhe (irtT fllsmttit 
in a list? Th* choice i^ ^rh\\f^-^. 

LOGO prev^nU such hfrn^riy rrts. Wta-rds tv^luale ms vw'idbk^ only when pfCMded by V, 

... X - - c Buses y lo evialualB a? j proteduire caSI. 
... rJiC . . reluri^ the value o\ Ihe variable K. 

thus, LOGO and LISP stiare Ih? p&w-«r ol allOw-rtg anj^ atring Of lolter^j lo be Higher » pfQCEduru Of a 
variablB n^me. But LOGO inaiiti tiF* ah Urtirtbiguoiis "l0c*l" distinction^ Indc pendent of position, 
between 5tie&e 1*0 uaei- 

Another i;r*mple ot the ckver wa/s Ll&P (ike* advantsg*? oF howonymt if NN.. L15F usej 
this word to name bolh thff empty list artd 1h« iDgical Irulh vjlge F^ISK. This tan result m more 
sconqmital procedures, The cOnveniente^ however, hit no conceplusi bMis. Henc*, i| can contus* 
IhE uwr whfl does not ypt i^defsland either list manipuislmn or logicaii anjilysis weH. This is stmilar 
to It>e siluation in APL, where tht logical cPnstarH? are the integers and 1. and conditional* *re 
accomplished by numerii:S.l tnanipulatLtin. II t*« lead lo obeturli^fi the purpose Dt a ftiven piece of 
coiiIe. 

Une orienlcd input 

t3S-P evaluafes iSn enpfessiOn whsrt parenlheses tplance. Thus il c.*nnot catct> prrors caused 
by typinE 100 m*ny right pirentheaes. LOC>0 *ailB Fof a c^rTiate retufn. Hpnce it is cap?.bte of 
recOEriiilna this proilent. Furthermfrr*, s. user can writ* several calls on a hne. ExKut.nn is rteFay^tf 
until a carriago return is lyp«d This has the yirlye ol sepaf stIiKft Ihe lashs d <o™ing granm^tical 
expressions f*Qff\ exEcutihg prgsrams. 
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H5P L0C30 1^ dB?r^n*d ^0 Ihal Ihe use? mi4 mv^r \i^<*' lliat hs is eomhhMhtc?(ir*g wi|h 
qlhef (+n»n i BtarnJard LOHJ. HD*euer, if c^^^sjred^ h* can inser f par*ftthe5H«l Lt&P cCcte anywiwra 
hn his LOQQ program. 

Ll^f* LOGO is hi?lciHy 4 ctHnpilnr. It converts LOQO iftpul t& LISP programs. Ttie result i; 
that i-unnirtg m&fl procedures lake* le$$ time titwB tha code need nai 1;^ re|ie*t*dly interr>ed and 
parked, 

Tho lcllci'*fir*E psget provide arv overvirw of the maif>r parl^ ol Ihe system. Thi^nr- atc Kb 
Kinder, piirsef, ewsltjalor, prmier, and prrgr K^n^ler. More detailed explanatlori! 01 Ihcsc will loltow 
in laler seellohs 5' thus mwi!*. F*r implen(ieFi.| alien delails, tlSP lOQO i"? available in weli-commented 
Interprfttiv* cede. 

Code faf th* LOGO (HstJt*/ (ufdi is. discusied m Section 15 tnd Sftcli&n il^ and ctKJe for ^he 
WLiSie t>Oif in Seelion 16. The ""LOOO pi-Ppet" is concerned with more 1h*n tht tlcvcl&piPBrl di a 
compyte? lariguflgs. Or una jar inleresi is. Ihe (Je^ien of vjTioire cflmpuler-driyen devices whrth 
pr&wIdH a rich problem solvine envifOnmc nl lor llw student. However, speei*^ t*urp05o primitHvet for 
driving (heit dfrvkcs are indepgpwJenl of LOGO vergias LISP iasi)*? snd must be added individually. A 
LlSP-ba^ed imple»iwntatiorv does have one sumjIbI virtue. -Kor those devices like the mysLJc bOor T*hk1l 
are driven tiy ASCII characters, Ihe prinwttvei can be writle-n nn l[SP or L0(SO ar*d ttien compiled. It 
k not rrBcessary to create c-pde 4t 1he maitltino lev«l. 

Tl^fr lOGO reader is basically a lioe -oriented lE^P read^^r II returns a li?! e^ atonic read 
between carriage retyKits. Ths fundamental task? ot inteiming Btomt and b^jifeding kst s true lure are 
handir^J by L\SP. Co^nljicls. iri character syntaii and i^^lprtlififtrs belween LIBP and LQGQ preaenl Ihe 
Only subttetfES. 

CerUiii characters suet* as the infix operators *■, -, ±, and / di& not require soaces to tie &el 
on as atoms. This is equ.lyalent to beina a 'single charKler oblecT in LE3P. Qlher charaettrfi such 
as V in cjolted pairs are special m LISP but no! in LOQO. The solytioti ts these cSn^hcts is found in 
usirB lepara^e ">« jtdt iftilt-'s for LOttO and LISP. 

Co-nl^licls in narties al&Q occuf. Ihe LOGO US*r has access ta all Ihe ordinary LISP 
procerfures, but muit bt pt-tvente^ frtj™. access'ng LESF procedures which art iriterrtal to LlOQCX 
Ttiifi is atLQmphshe?d bjf using tw* "pba" ays". When the user types m an idtnSilier wilh Ttw sinw 
n^me a? ^r irlernaC procedure, he Kcesses a dilFere^t dl^hrt, 

MACLISP" allows any number Ot tepafa.te ''readtaMe"s an^ "cibtrT'j|y"s. This permits nuiltiplfl 
wOrWs - PLAMMER, COMNCVER. LISP. LOGO - Ifl cO-oxist wilh mj conflict. SwilchiPrg worlds I* 
campu^atiortaliy fast. All th^t is necessary Is lo rabird Ihe REnDTARLE and OUAJ^FAY variables lo 
the desired wOrldL On the other hand; the naive Hit* H protected cOmplelely front other 
environments and need riol even hnow ol tlwir evistence, 
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Tht pflfser converts 9 LOGO line (* li>sl-sti-uttUFed Fofm. Thi? rtouwe* Ihal intamiticn on 
IfK number &f iripu1;i u£*d by a prcKcdure be BwaJlaWe. [nsflrlins parenthcs^cS. is s trivial 
contpu+afmn for pHocedures *i|h a fined number 0l ihfujtt HoweverK cflmplft-HilisL are introduced 
into the LOQO p^r^cr by-. 

J. Having inlin *? w*ll as pre Fin bpcra-IOi'S. 

2. Cbinginp^ Ihe nurrber oF inpy[* dEpendSng Upon wFietFier the iFsSr emlM*JBd Itis (orm in 

3. Pfimitlvei i|ihe TO lhji| *i not parse IFieir inpMt 

4. HamonymsE Fun^lionj *hicFi haw Ibe sarrt* rti'Vie in LISP ar<3 LOGO, hut have diflsjrcnt meaninES. 
The^e ^r<f handled by having Ihe parser del get lh* rt*fnei oil LOGO primitiues which sronflitt ■vwith 
LISP, and co^verl FFicm \q functions wilFi diderfrttt nafliet Ihat do not conflict. 

This maliBS Ihe parr^r Iht mobi ccirnpiicaled pari ol Ihe Eimulilioa 

Parj^irt^ information «s siftrcd Of Ihe p'operly |ii!.t cf ^ lunttion. Th« majoi- sub-prCKedlur«s 
arc t^nctrned 'wil h prelix, i-rtfijf, and user-lypcd i>»<'e-filhfiies. 5pBt:ial pi'imitivei are psrsfrct fey 
staring a prOEedurfl S& th* par&ing prfrperty- 

J.1 Evatuation 

The bi^it LOGO lunclio»'s that do tFie user's {DMputafcson - t.f. Ih* arithrretiC, 11*1+ *ir*d loeical 
primitivBC - fe the simplest part o( |H# simulaliOiv. These tunc lions iW Occur in LTSP^ usually in » 
somewhat more General form. Hente, Ihii pari of the implemEnlation i* iitHe wore- than rcr^sminE. 
Fqt many pr^milivB?^ LLOGO provides mOre jreui^ent type checfcing rnd infDfmati.ve errOi- mesiEges 
Ihan arc Eiippliefl by their W^P cOuntei'psrtt. 

P*r!i-ed tflde is eweculed dirfrtlly hy tha LISP Bvsluatq*. Indeed, a user -defined program In 
psrjed lorm is simply * l[£P P^OC. The lin* nuhib*f£ »fe lag? in thp PfiOC- 

a.j Printing 

LOQO procedures cnuld be represented as litts of unptrstd lines internally, in lhi? case, t 
line nnjst be mterrwd and parsed MCh lime i1 is Tun. **jWver, Ihe problei^S of prmling the 
delinilion a^d editina a 1urt1jc>n S-r* siMfpNIied. The infffrna! Fat rrvat is idenlical to 1he furmal in -^hich 
the li*«r qr iginally lyped the tnptesiion. 

An alternative sOlutlqn i« to represent LOGO programs in parsiett, i.e. LiSP FOrni. A LODD 
prtjpram iTileinally is 3 LISP prOaram. This mayimi^c'i run Ime Speed ar^ iiimpliiie* buildinp prOBram 
lunderslarKJer?, It hii the diiadvanla^j* 9f eonfiplitatinB Ihe p^irner and Ihe prin.lBr. 

1. The pa'stjr mu^.i handle lunctfOW th*l have nol yet becrt defined. This tin be accompiishsd, 
hdwevBr, by rf/erling Ici the sOlutiOft <>' parsing a1 run time those (ires which conlain unKncwn 
lurT^tiona. This run-liine tJir^ing can alter Ihe pi-o^i-am's defifiilion as weH %o it only need OCtur once. 

2. Pr inline defmiliOn* *^td ^di-ting lines rsquihe* an inwerse parser pr "unpartar" whkh returns tNl 



LlSP-i'ie-di to4f Id Its anginal fQtm. This 1$ cds^I^Ig prnviding there i^ riD in^ornn^lion lost m parsing. 
Sucli is the Li&e H Ihe p^r^er makes, special i^rr^vtsion 'or drslinguishing UGer-typcd parentheses 
from ij^rser-ggngrflled p3rri:nrSc-5<^? One wjiy iQ !Ktq-rii|iii*IV Ihij IS b'V t>sginninfi us^r-lista with a 
do-nothirVB (Lmction IX'iKff-PflfiF.'.V detined k: 

3, Editing lifie t\it^^ li m^d^ r^Or^ t^cytfipie^, |1 the nufiil^fr c( inpi;ft£ accepted by a Function i's altered 
by editing the tille line, I he editor must reoarse Ihe lifwa 0' super-pr(>cedurBS in ^hi^h ? c^H t* thfr 
Ihc: t;di1c?t;l f<ur>(ti4n ^pp^iyiprs. This Can be a^qtuplliEhei;! b/ maintaining a super -procedure Irsflp 
allhrDugti LLODO dtjes no! cuirepitiy do (his. 

Thete cntt^plkation^ can be avoided by stdring bdth raprD^Bntatp^n? tt the pro^tii^urt^, Thut 
is an CKtieSlenl example 0* 9 space v#riui cOmplcjrlf^ |t^.;?¥-firf. LISP LOGO tuffentty dn^s no! store 
both reprssonitatiflFts, 

^'mzB LOGO ■& a I'^n^v^CO wHta(li 1$. designed iQ he u&ed by^ begrnrang programmersp it is 
Important to provide in1ortn^t<>^'e error n^^^i^es- Cpns^quentjy, all LQGO primitives dO exismt'^ 
|)rp* chB^King on ttieif inputs, LLOGO W"lt try tu pr-rr! out tt» farm which caused Ihe er-rOr, and giv* 
Ihrts line' nyhitjer if tt>? epfnr ■occurred insi^Je a procedure, A'ler a siivole mistyping ^"'0^' ^hi^h ■tan 
be delected by the parser, the u*SBr is gifvcn an immrdinle flppoftunity ko correct tt*e iine. For run 
UmiC flirrors, ht i-,^ given ihe option of causing breakpoints. Fscilities (Or eifplOrir^ |hp «|ftk from 
inside a breakpoint kodp are svais^ble. Smrc LOGO prpt^^iires ar* fepresented internally as L15P 
PfOctfd-UTos, thi« 5.t*nd»rd LISP TNACK patkage tan be used. 

rh«s« IdcHrtiB^ ire- iniplcrnenifd using LISP error interrupt handlers and KVAtrt'RAMK. The 
saphisticaled uier desirmg, customizBd error handlers ■can iete^t Ihe USP Facitilies dTCrcUy. 
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Section 4. PcrfDrmjncf: 



41 Silg 

U5P £6 OkJck^ (10^4 36 bil wt>rds) 

LLOGO (compiled^ 3 Btnary pforgram 

4 Uurnters, Alomic symbols-, etc. 
Tfltnl ■spste flS 

TheBB Ngure& i:te nOl include space 'Or user progrdinst oc lOadirig Ihe display lurtlB^ music ^ 
<ir G£Rt4.AMD pjickjip^ijii, QctwcUn 6 fni 3 OK bey^^rid the jimount of s.tor*^i; mcTikiflrtctl above wduM 
pruvide a reasDn^b-le aD^sunt Q<f workspace lor user prDgrans and dstai Ihis would correiporKl 
rouijhly to [brogrdms of perh^py a iev paiti. Tht i\^utti dbcve are 4or \ht IT'S Imple-menlalionH af\ 
DEC 10 ^yflgms, it Occupies fligtidy less space. In Ihe currant MACLISP, flOrage expand? ?s needed, 
ULOQO lakes ^vantage cif this feattire — li programs grow beyond a cerl«n size I ha user i^ as^ked 
whelfier fie wishes f^ic allOcaSiOr* \o be increased. Slfrfsge is ei^panded iulOmatically en rosdir*g 
special packages such as the display ttjrtle. Of Ihe 17 blocks which comprise Iha LLOOO systern, all 
Ijyt 3 Sir* pyrt, ^nd c^ri be th^re^^ iiEnq^Tig i^e^s, 

'i.^ C^tnpuiatipti Tirrtc 

For iflosl proteiting. LL0O5 enijoys a speed-up over CLCJGp and 1 ILQHJ due ti Ihe fad 
that pafSHF^ii; nnd in1«r^lnp, -QfCMr Only ant« dt de^in^ tim^^ Fljr1ht;r, liOQO nvaltes il possibtfi I'D 
ci&mpile LOGO source pr^igrarps inl4 machine cCde using the UACLISP ■cSmpiicr F&r increased 
efficiency [See Section 9J. Workspacet can be stored orv the dis-k in inlernBl LIBP formal. (See- 
Section lOJ] Cnn&tqufrnlly^ ff-rc^tling lik^ has no c^ei'h^ad. CLOQO lia$ an adyantag^, howe^er^ 
in manipul^ling wOrd^t ^s its irvlernal data slTuclure is string ralher thar> Iie1 ArienledL 

4.3 Us* 

Almosl all of tbe pri^milives of CUOOQ ind HLOQO^ [kK^uding the music boic and di-sptay 
tyrllfsj irrt impl*fFn^ntnd. l-lcncr, \,1%P lOOO li tSpJttJft of l-fiacTmR, (ijlrsina (rtd runrting (n^St f<l*S 
taved under CLOQO or lllOGO {perhaps nacesiilating minor "modilicaiion]. 

]t can a>lso be used reaF'liivie by an insftyidual famlinr brriy wilb LQO^H: no knowledge t>f LtSP 
I4 r^quii^^d. Ort 1h^ Qlh^f b^nd, ^M of L]SP'± lacililie$ ^r^ avaHabl^, PrPgrafTt£ ^^rii b$ wrMtla?^ in LI^P^ 
Or in machine r^rgusge using LflP, and made callable frOii LOGO. 7tie speciaf pacKajes f*r 111* 
di«|>l*y Iui-Hb, f^uiit \^x Jtn^ GfflMLAND eni ^m bt y«d from firt ^rdirtjkty LISP, *iSh(Hi| tb# re'ct oP 
Ihe LtOQO enuirormtent. $om^ other facilities of LLOGO. such as 1h^ brs^kpoint and slack 
hnari pUlatinf lunctpons, are aIsP avai'abl-e fbr use in L3$P. L15P users can take adv'anlage *f I has* 
f^tiliititt -wil hoi.it lil^f^^ili^n vrlth LOGO^iTifiiy by loading the appropn^l^ 1ik$^ f>f LI^P fitin^lions. 

Ths implen^niTaliftn is wriltan cCriipletely in interpretiye code. It runs compiled uhder tht 
MACLISP Cur^flndy in ijsb at t*w Artifiiial InlelligfrnCe LabOralory. ULOQO has als* bopjl implem«ntedl 
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qr sUi^d^r'd 0€C PDP-IQ"^ ui>deF the TENSO ind THCX syitems, *nd «n MULTIC&. Thwait 
iinplvniffnEali6n« are discussed m 5ec1iori 12 and SecliO>^ b3«4 Ihk nt^nv^, 
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SectlMi 5. CgttiTig Stai-If d 



In the Follo-winE teclions, we w«|l |lO Intfl trtpr? d^tjil toncerning ^he imple menial iSn &f Ll^ 
LOGOf aid t>rovi(l? iome pf acSical inforittalian lijr ireiiYg it. We will n^i jtlerupt |« fii'o^jadis Iht reacter 
wilh an introduclion to Ihe LOGCk liinguSg'fti ?*^er'il txteUenI scuur-ce^ Cor this Bke^dy exi^Tf suth *S 
the LOGO Pnnwr, ^n^ tin? ] I LOGO 1.>ef'$ manual [LOGO memb ?]. We wilP Kiumft 1h*1 thf reader has 
fead these, or is already fBmiliar with CIC5G0 Or IlLOGft !He olhec ftrtplemtnlaticins of I he LQKJ 
lanEtiage available a1 the At Isib. [nsle?d, Tff will t-oncentrale en poinding out differs nces bctwc-ti^ 
LLOGO Jifid ottnfrr implementations at LOQQj. and describing fealurei uniqu^t tP Cvf thiplementalion. It 
is fiol nece-stary to t^no-w iISP f* undcrsti'^ mpst ql what taklovn, aithaugh some knowtedEo- &' L[SP 
wOLild tntt hftlufu! in aainifij intighl i^nSo Iho iirnplen^ntfllien, F^r mor* irtfofmaliafl on LlSPj see It** 
MACLISF^ PpF<frenc* Uang^il fay Pa^^e MoDn^ ^nd Itie InJerim L3SP User's Guid* (At metno I'SOJ by Jon 
L WhUe. 



Naialional convenhont; Throtig.hou4 (hij rrt^tno, [.iSfiW TTPEJiV and l/JCiJ COf}fi mti 
QPfii^r in a font Uir thix. AflHREVfATfONS ftf t.iiCO pfimitiv-f^* i^Hi ln^ mUrJ iji hrar.rt { ). 
SYSTEM TVPEDUT will aupcar in. a twnl likr this Centra^ charBc[e'^ are denoled by a f&ll(iwt;d tiy ^^^ 
<har^ct<;r. Vou type a tonlraji characler by hotdirvg dOM^n tN? key marKert 'canlrol*' while you are 
typing the character, ju&t like yOu wQwId it&e the 'shift' hey ta type a capilal letlE?r. t mam ^icapB 
Of iiltmodfi, not dDllaf-siEn, except where plherwise nO-tcd, Angl^ brackets < > mean something, *f (he 
appropriate type s-ueecsTcJ within tte bfitketti lor instance, it y*ur U5irr narme ii HEfJRY, ^user 
name> means your user namef e;g. HEMBY, Esi^ept lor cofrirnk charKlert, wtiich ijsusKy t*h* 
ItiHn^dPi^te *ffe*t^ *nd except where olherwise n^Jted, and pll l^t *1 ly^im with a tarriage reluTn. 

ThrtJ Iflll^wirrg p+-pt*dure is intended lo help very naii^ u^ers ol [TS 1o ^et lo£e*di if? ^f'd '* 
otjtjiipi tlSP LOGO. &ee Al meino 215^ How fo G?? On Ihp Systfrirt, Ipr more del ails. 

I. Find a free cofisole. If i1 h a TV cOnsfllej lurn i1 Oi^ wi^a the awikh an the -gray bbx mounted on 
th.p w*ll, [1 r^houlc* Tihow the names ol akl Ihe users turrently On EN? sySi*fn, OSheir typet qF c^inwlet 
wilt shrow the mess^gej 

ANTS <vwf\an^ EOHSOLE ^Riamfer> FREE. *i||ti*>, 

S, A con-sole which is Free tM>dersl?nd5 O^ly one tommarpd, aZ. [on TV terminBlsij use the lK*y wtrMd 
C/tLL, Thp computer will respond with Ihe lollowing message^^ 

A[ ETS -ivrrsinn^, DDT '«venih]fl>, ' 

<kijmilKr> USERSi. 

3. When il stops print ing, i^jgrn m tt^liykii type 

■.lAiCtN <imrmtmf-' 
LI th*r« are any ntesiages For ymj, 
-HAIL- 



will be printed. You can iypt t ipiitt le receive 11 ar any other clurKttl- t» p4^tp(Kis it. A « will b« 
typed *t Ihs end. 

fl. Mfiuf yflu have completed loggmg In Iq Ihp A1 syslBii*. Ti^ gel LLQGQ starled^ 

5. Decide which yeriion qf lISP LOGO yflu wanl. Choose Irom: 

11,000 - ■Stjjndard version tit t[SP I0i30- Votfibgljir-y is conipstlEjIc wilh It LOGO. Section 11 contairva 
a detailed ccmpariaort at I his vejsien o1 llOGOwilh ULOGQ. 

CLLOGO - A version which uaea a (/n?*^Ur'y which h cOirpalible witht]LDQO. 

NI.10G0 -Thff vflj-y lales-l version o( LISP LCK50. Thij it eKp*r imental, sfl we make no promises. 

When yqti d&cuJc i^hith you wjnt^ type 

for e){amp-!e^f^/.Hf;r.t . 

6. Then l,(.OGO *i|l print Out s.Ome irvilial mess^es, including tti veriloh rtvrnl>tr ?nd Ll^P''?. LLOGO 
ha*; ?vail»b-le fiflvaral packagei o( specral fuAcliont, if<4 yOU wid be ashed which nf theiE ynu ara- 
going Id use. If yciy ir-e «l TV r&njCilej Ihe Flrsl queElion will be 

DO tCL WANT TD JSE THE TV TURTLE? 

If yflfU want la g« the lurtlp eOmrninA l3 dispfsy pi^ilures on your terminaf, yg^i jhpukf jn^'wei' 
VffS. Vou shftuld also answei' VA\^ ii you inteni^f ||i> ^fefin5 &r eiJil j procedure containing such 
commands, ev*n it yOu don't run (he procedure. See Section 17 for details on I he TV tyrti*, Sf ycu 
*r6 not logged in a1 a TV tefminarl, yog ca-n vse the lurtle en lhe 3^0 0^ OT^O diaptays inslead. 
LLOGO Will asK 

DO iraU WANT TO USE THE DISPLAV TURTLE^ 

If yait sh^wc-r V/tS, ij will Ihei Bth which diEplay you want lo g?*- ]t h tipt ttC-tifrriSSry Ihst yOU 
have the 3^0 display iCQp^, t»^e PDP&k Or ihc GT4b displ?y, 10 do jusi deFming and editing. You can 
•Vftn riin the prd-cedure if you do not mind nal b^irtg ^It to $et; wh^F ths procedure does. Bee 
^^iipn 15 for mOre mfOrmaliOn. 

dEF\MLAND? 

It yicMj want |* |tii*^ wi|h GERWLflINO, fhe display tuMIe tw tharactsT displays tuch as OATAPOINT 
ICiTtilnals, ar^wer VKS. This has a pr-Dmpter whkh w>ll run same dc^onfttr^li^nt, «n^ provide help if 
you need it. Ajftin, i1 y^u Inland tfr d^rirw er Bd«t procedures desijnEd ta run in GERMLAND, y^v 
logst answer YKS- Se? S^fti^n 14, 

MUSIC BdH? 

tf yOu want io use LLQCO music boM prirnitive«, answH^r FR^. Ttiin. will mqulrv further, p; f^ which 
inusJC box^ fr^L 'Sv@ SecTiOn Ib^ In case y^u hsvs answered Ir'^,^ to any of thes^ questions, yoij 
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h^-j^ to w*lt lor a vi'hile, because i! lai^e^ eOitw lim 1« to?d in litA fik*$. H yQU< v^ant la inlerrupt 
iQafJiPtg '*n Eype /hI , riol Af. JF yOu chsng* yotjir mind jihout *an!ing any nf the siib-sy^l ms 
itienlionEid flbCJvu, y&g Hjjrt £0 IhfDugh the iraliffl queiMonn-airc ^ig-nin by calhnj tKft funttian 
AiAJiXL/iTOR. IF you ^hay* 3 lilc nsrwfd ^.J.OCO ftNTT} on your direclory or there is 9 fi|o narned 
■=un*r Fwmj^ .M.f>CO. cm th* ONfT) dj-reetcwyf LLOGO will read i1 as !in imlialiE^lion file, ewetutjns 
LOGO tode contained IFiereirv. WFian all Ihis is linlshed, LLOGO will ictditate ils readijiES& with 

LIJOQG LtSTEHTNC 
•t 

7. [f you find youfself in the untorlunale ^iluatifin &f meeting, a bu^ in LISP lORO, you m&y report it 
by yiinE I he tunc tie n SUJG. The inpul la flUC should be « rrtestaae destribinj I He dilFiculty, BnclesBd 
in doHar SKgni. F^ir BKample, 

EUC $ 

f 

itHANll YOU POFl YOLTR P^TtENCE. 



*. You can bgiiul when yOu a»e finiihftdl b^ ly^Hlng COOWflVK tn LCCQ. the terminal should thtn 
-say, 

AKD A PLEASAHT QftT TO irOUl 

Al ITS '^v«;rwfi> fXlNSOL^ 'ihUmb^v FHE£ «tiRiE:> 

a, Msvfr lunit 



Sectiw 6. Pjtriih^ LOCO 



Tihi$. ^tctiDfi will discuss a few o1 Ehe more cninpln tt$u«( in parsing LOGO InIO LtSP,. end 
di&cuss how ihey are hancMed tv/ LLOCO. lISP is Uivist lo pB»5a, as lis synlax i& toially 
unamb'suous. Thr application oF a JuncUon Ic its inpuls alwayi happefiE in prefin nolaEion, #ni:! the 
p-rftcirii; synTjclic ejflent ot a form is always cle-afly delintated fty pprenthr-s^s. LOGO ^ynta*' il 'orris 
3 he beginning CToarammer ioimft tQnvertiericcs Over LtSP synlsx, whils retaining much of the 
ex^fes^ive power Of LlSl*., ParBnlheses can be omiUert iurroundiing frvecy forrn^ and the n^Ore 
customary \f\i\% flOitilion Iflr anfhmelic EyoressiOns can be arbilrarily iin1*rmin^lecJ *iilh -pttfiiM 
nolalion. Thest conwenieiHtti are bcuehl ?! Ihc cijsl ol cSrppiicaling Ihe parser, and introducina some 
cases whi:;ri^ ^mbiguHy rs^ulls regarding, Jhe user's i'nient lor icmt of the l^n^ui^^e'i isynticlic 
conslructs. 



6 J Infix Exprpsiionj 

LLOQD allows inlix rtdlalidn td be used as well as prefix functivn; in arilhinetk e-vpr&s^ior^- 
'Mosl LOGO afithirietic iuKtctlpns tK^itt in b&tll pweht: and infix fl3vdr&, and the usar is tree lo use 
whittiever he desires. 

PKl,ifT3'M<-./iASl,'M FTRRT:% lilFFKREfiCK :C:\:i7 I 

\% tlic $airt« U 

kJLOI^O obs^i'vvs. thie usuat precedsnce and assDclativily df arilhrnetk operalors. 

' Nate thai a complication q4 the LOGO £yntj;r %% thai alt fuAClione, not \\Ji\ infix OperalCr&K 

•re required to hsv* precedence levels, ts 

FimJ A T 17 

the san« ds 

rJArESfF/J?^r:>3J N or f JWST iT J JlfF5 :>! J?; ? 

The situstjon is fufthef compHaied by the user's probjibic cispcctaliO'n Iha! 'unclioms which 
maniipLjI'ale Icgkai values ha^i's lower precedence Ifian comparison operator^ tihe- <, > and ™. SlJ, 

TKST.NUMltFIR * .PI 

1$ t*her» to mean, 

Tt:ST fLF.SSf' riWMflK/f iP/J *nd not tMSSP fJEST iJVL'JMJJfiAJ rPJ 
CLDQD gives aH aritl^melic operatof s the same precedence nn the groumds: thai precedence 

Purging LDOO St^liim $.1 
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wculd ha dillicult 14 Explain clen'ly 1c chlldrch. l1Q'W4^vI:^r hhis hn IHe drawback dI deviatiirbs Ir^in 
tho- EU&EoriAflry malhematieal cortveniti&n, Smce the nnci1iva(=Dn lor intradueing ihlix r»0(Eitrfln inl* LOGO 
synt^if is so tha( arilhrnetic expresskins can ht ^*fMt^ert m Ihc inftsf Fflf m in commqwi Lise, LLOGO 1l«ft 
been designed to obey the u&ual precedence ca«(/enliont, 

LLOGO trie^ Id please evet ybody. IF yny feel th^l the precedencB Echeme *hkhi hti b«frr> 
i ntpleme nted does ncjt n^rcr wth y*ur intuiliin, you are free ta t*defiry; th» prpcedence levels as 
yqy wisti. LLOQO aka provides fhe cajijljilily cyi tfefirting now infix operatars. 

The iniEiaf defaul? pretedenci^j are ide^tlcil to thow Off I ILQCQ and are as Foltflwsr 

70D: .^ [eypDnervtiafion] 

600: * - (prefisj 

500i :iL / \ 

400; * - [inlix] 

300: [default pfe-te<JBnit» fOr system and user funttien^J 

200! ■! ^ - 

100: fF .Wr KOrtf KtrftEN A^'DOR TK$T 

SOi ^ iMtnKK] 

IriFliilly, flppT^SiOrs ^t Hevflls BO and 700 i*t fl^h| ^jrj-Oci^tivfj, ar^J the re&t are Foft 
(SSOCrative^ wFucFi »5 flw default. los,\<t\ fvnciiOns stiOuld have precedence tciw^r fh»n ^(Smparr&On 
operators., so if (1^* user defrnat b togkal. fgnftign he should S*t Ihe precedence himself, atFier wise it 
will receive the defsuM prerederKs. The ubet cancha^is.^ Ihir^^s by Usirig Stie Follo*ir»6 functions; 

Re tufflt thifr precedence level fil <fiip>. 

PRECEDENCE <afi^ -^Ifv^y 

Sflts <op>'s precedence level la the ftpetided <ltvft^t wlwch tM^ oilher be a nirmber, pr 
another operator,, wtiich rtieant jhi^l ^i^py is ^^ be given the same precedtn« *? th?t «ppr4il4r, 

PfiECKf>K^ClC mL <in>ri> 

Sets th* dt'a-ult prffcadencB FPt Fur>clinns 1o <iriH\l>, b,\\ lunctiflns which wo noi in tha 
*hov« l^st oif Miv. lunctiona, or have npt hvvn WEi^ned a precedence by the user, rfrt(?ivt th* 
default pfecedence. 

OecFares Ihfll all functions o( prscedSneB tevei «jiiijwfe*r> wtlF sssoclit* <«fiicft-iMy*, wtuctt 
is *ith*r 'LE^r nr 'RfiJUT. 

Define? ■:*p> Jo be m intiu opefttoK o' prccedgnct -^irt/tl^. Speciljiinift a pretedefKe fs 
Optional. 



Fgiree* M infaif operjil-dri tu the i^mc p'scecjcnce f^wel {Ihii will be higher than tf*e elfrf«ull 
pr*e«<i«Ftc4} Wahes L[SF LOGO look like CLOCO [weli, altrtoil...} 

zINI'TX 

THi vffri?b1» ctSnIaiiYS 3 \'nl &f all cuFrenl inPiK nperalors. LrjoK tout don'l: tflUC^. Us* INFIX 
to add tii-w inlii! otxrator^i 

Ttiere it -Eome ambigijity in the hjrtiiJIina of minut Sigpi. For cvjiMpie, corwiider 

(S^iyTKSCK .1 -:/lJ 

If the HMiiLri sign Is mlcrpreled as an in4iK dilference cperdtor^ thi& will re^i^l in « ll$t o' one 
rtrmcnl. jP Hie inini>5 sign i^ inlerpreied as prefiis nesalian, it *^ill KssiiK m ? Il^l o' 1*0 i^lrmenU. 
CLOGO uaei the spaces in the line to ditambfauilr- Ihis ca^e, JF [herg ^s- a space beNeen the minui 
Sign ^nd tht ^/1, it 1^ irtteirprelE^dl as iniixK Dlherwise^ il is inlerpreled as prefix. In I HOBO, s;^iic«$ 
are nOl temanlicaHy significant except lo delimit '^ai'4%, ^o Ihli^ i^ intcrprsled a-s iSKNTKNCE 
fniFf''KRf''-!VCF -1 r/1..'V rpp.iirdliis^ of The Occurence a< spaces. LLOGQ treats mirtus sign as does 
11 LOCK). On« vduld dblain 1he result of the other interprelaliait by usmj 

(StyfKNCK 3 f-r/lJI 

Tte preceding djacusiion applies cnljr to the psrsmg &f inlix expresfiOni. !^, [-+} is a list UP 
Cne s-lement, a r«gative nuinberK but [^ 4J ii a lisl n1 Im/d element}, mifiuj jigi^ jrnj 4, 

€.3 HgrncnYTTis 

LLOQQ makes all Etve (unctiofM of LISP diretlly KtftSSlble I© th« LOGO user, in exactly the 
same way as LOOQ prrmitivE'S. Tbis runs Jnlo difficulty wh^n t LISP fuK^liDrt and 3 LOGO luficlion 
havB I he ^ang- rvarne but diffpreni mearHngs. These are currently handled hy the fi*r5*r, 'j^rbich 
tpriMierSs thH-m irttpi mnorifous st&ms Mi/Sich do not c&nflic1 wilti LtSP^ and are reconvffled upon 
unparsine. CuFrenlly I he following functions are homonyms: 

PHf.^T, R/l,\mm, L/IST, EDIT, [also SAVF in bhe MUTfCS wrtivn] 

When I tie us«r l^pes in one o1 th«se, it it conL^e^ied by the parser to j<n mlernj*! repress nialion 
consist ire *' 3 drfferenl function nanw [tJ^GO-FHfPR'. LOGfi-LAST LfiCO-KDiT WCf^HANfyOM or 
LOGG~S/lVRi af. appropriate J When She user recn>*f.1;^ th;i1 the line be nnnltcF Oul &r o-ditcd tho 
unparscT converts it b3cK to Ihe way it was Originally typed in. ]n I he CLOGO-compalihle version of 
LLOGO, when <LnREFiJL is not sei lo JVfl. I he folio* ing pTimifiv^s which tonlkt wlfN CL0Q3 arc 
also chansed by Ihe parser; tMT \z changed io PR/iVTTK.T. 0F5Pf.,'TK to 5T>Jff7'Df5PJ.^V, OET 
and AE/lCl 10 HF^Afi¥{LKt and iXi Id HL-N^ Warni'vg msssagei are also printers in ttiese tas-es, 

there is crn? pilfall in Ihe current method ol handling honwnyms: sometrme'S, tt, wilh planting 
functional ar^uments^ Ihe parser does not get a cnawe to do ils thing, no 1hr u^^r may ImcJ Jn 
unen petted fmncllon tailed; AfPhV 'PRif^T ^M% LISP'? Pftf.Vf funcHon, nOl LOGCTs. 
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^■4 Abbrcviatipin 

Abbreviations sre KcOmplislwd in LLOOO by puttirig Ihe name ol fht (utxtion urhicHt is 
sbbre-wijterf <jn the properly iis-l nf the ibtreviation ai in fXPR ar FEXPfi prflpflrtvi as apprOpriiatB, 
Abbreviali(?na ar* th^panijlpd Irito thpir lull 'frfT* Sn parsing, and are feM Ihal way. The user haj ihe 
£apabilFly Ot creeling new ^bbrevJatiDru by 

ABURKVt/iVF ^/Pim name^ <otd nQm^> [AS] 

#nd erasing Ihfrin by 

>]|fllflf:t''MT'f; evBluatea ik inputsn btit Efl/I^J^ckiean't. A ccHinplete lisUng of abbreyl4tioi!K, ir^ Ihe 
names of pTtKtdwf^s flbbrevijiled. by ihem, csn be Obtained by doing 

FRiSTOb'TARnHtVlATIOSS 



Sectiiin 7- Dffiiling and iJJ^ttng f unction J 



In LOGO^ when fN? user defines t procedure usine T&, Or EUlFs • procedure ht hjt 

pfifviflu^lyr defifved, LOGO enters an "cdrt mode", wjitr^ hnet beginnma wi1h 3 number arr m^^rled 
inSo the prqcgdure under m^idiFicjIiwi. LOGO pffOmpb wMh '>" nlhcr [hsn "?" 1q indicate lhi&. The 
tnlent ol havms * sirF^arii 1 1; mode for ed-.trng protedu^ea is l« stress 1he diitiflcthOn btrtween defrturw 
prOcEdure£ tnti txecutrnfi J her* This dislirtliun ■£ i>5f strict V mBinlnned! if Ihe line does nol b*ein 
wiJh 4 number, the tOHimar»d& are eK&tyted k Ihey wmjld |?e erdirHFily, with t few ewceplioni [Ihs 
user .£ prevflFited from dQins eh.,?: her TO Qt fiOff hr inslance]. OctJ^iOnaUy, this fe^d^ to errors, 
lor in&lanci if Ihe user inrgol (^ type |he line number a\ the l^oinnmE 01 a line inter^ded J or 
^nsarlion. 

The default ^f^ile of LLOQO is ia ^r^^r tfv separatism fli adit mede from nt<iinsty nwde aa 
ir 11 LOGO ind ClOGO. the il-ahtly more sophisticated mir, fiowever, might iind himself in am 
unnece-j^^ry loop o( continually lypins EDtTi ^hd fi-W's while worki-^^ or, Ihe same procedure. 
Since the fines lyped by Ihe user- fqc msBrliOn inio a prcKjedure are inserted iMHiBdiately when the 
UStr tmiihes typi^ig thg line^ £"iVfl doe* nof cause anything ia happen olher fhan Ih* leirminalion oP 
edit n^jde. The Eysl^rt* jlw^ys remerH'beri the name ol Ihe last fgr»c|ion menliofled by W^ KDfT^ 
t'KlNTOlJT, wk. as 3 delault for these 1 unctions, sa *hen working on a sinalc lurMrlion^ KlilT serves 
ohiy to enter edit hnodr Thg use' h-BS an ojition oF lurnine off If-* srpargfe edil mode Uy seltii^ Ihe 
vanabFe EDIT.HOtiti lo NIL This w\i\ taus-e lifies beainftine wllh a number 1d hr in?pr1«d jrtto Ihe 
default procedure a^ any iirw. Jn ihis mode, it is mvvr rvecessary to use fr,'V/.), s^ti KDTT will only 
ch;irg,B Ihe name of the defauM proced^jre if glyen an input. The pr&mpler will rwl be chiingwd. 

In LLOQO, it I4 not necessary lo be in f<Sti m^^e tu use EUtTUSB or KDITTirf.E on * lin* 
o( The defau-M procuduref »nd th? 4#|ine cOmlrol charact-ert jre available even when rwt in edit 
mode, 

?■! CoTltfoE CJiaractcr Editing 

LLOGO has a MnfrOl-charactef line edilOf 5.imila«f lo Ihose rn CS OGO arid JILQOO. This iniKfr*' 
it parlitijlarly tonvenient lo correct mlrKir typing errws, by pre^icCng a means of tttythn^ pflrliorw. 
of the linch fyped previously, m^fpad of requiring relypmE ol Ihe entice line. Th* reader keeps track 
0!i l^vO lines: an oEd UtIo which you are *ditin^, ^nd a r>ew i\t^. wiiich ILOQO rs lo -use as (he nt/t jirie 
pf »nput. The Old line is sl^^ys the lesl line yoiS typed at LLOGOi escepi ir^imediately sfler a parsirsg 
error, ^h#n Ihe offendinj lir^ will be lyped out a1 yQ-.j, ^nd 11 may be edited- Ychj csm also iel Jhe 
old line ypy#s«if to be a line m Ihe Current default procedure by domg KOtTUNK <Iir\r. piPFnfr«'r>, Or 
Ih* tille Of « proMdurfl by c Slims FrlilTTiriK. Everylhing. you lype iWet the prompter, or cau^e to 
appeap ^l5i^g the conlrol -ciharactcrs, is included -in the new lins, unlil you type tarri^go relurnt which 
ierinirisles edlling for th?! line. You may yse pirls Of Ihe old line in COnslructing the rww lirv by 
using IK« foUoiving commands: 

AE 

Get thfl noKl word from thut iron] oF thfl old lima,, and pwl il on |he end oF Che new (Ir*, 
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Pti( the rest of ihe fild i™ at th* tml flf Ihe new Nrra. This l« like (fci*^ ^H's unlil thsf« is 

nothing lelt in Ihe aid line, 

AS 

Dtltf* a *ord from 1he U^n] t^^ th^ ■flld line. 

Delete a wtjrd frOpn Itiff pnd o( Ihe new Una. Like rubOtft, e-K?ept rubt out a w«rd inslead ol 
a draracler, 

LLOGO uses diMerent clniBrKler^ Ifr^n ilLOSO and ClOCiO do bec&uEe LISP uses nio&t flf ths 
CO^trril tharacters for intairupl 5 ^nd i/o, 

The LLOGO top leva] loop keepj a record ot recenl intorsctiona wilh Ihe user, t^e leHldwrng 
f ur*c t ions, iirc usetul Jrt telercii^ hack 1-0 ? prrviowily lyped in Nne, Or prtvisjutly producer* value 
wilhout re1ypin(5 iL 

WiltiOUt *n input, i./l^TFT'^fl/K returns the t*sl valu* lyped out by tht t^p leyel loOp. This 
ft like Ihe uariable st iin. LIBP. An Iript^t o( <li> So J.jiyrtf/IljL''i; roturns th# <ii>1h pcevious vilUfr. 

L/ISTFORM ^tf> 

I.nsrtVHlH rslurns the mosi retenlly lyped 'OTn>, like t^w variable * in Lt&P, Art Inpul can 
specify Ihe ■:n>Hl ItkI recent form. fil'^L LJiSTfr'OHM exetute* 1he las-t form (Jver tgjin, 

like t/lST^WWW 0, Ihi* fclwhns Ihe form in which tt ij tontamed, lika the virisblt - in Ll&P. 
LASTUNE^n> [lUNR] 

Relume Ihe Ifl^t Jor <n?th] previous line. RUN LASTUSF, etteculet tf*e lad N^e *&*\n. NoIb 
th^l 3 lirie m*y conlai-n jnore Ihan On* lorrn, 

tUSTOKY <n> 

S»ls Ihe flumber «i inter kMoiW rflmemhered by LLOGO 1o ^n>, Tnpu1& lb LASTVALUB, 
L/ISTUNK, and J./ISf f OW If must be less Ihan this number, which tan be examined aS |h^ ^^alue of 
the variably dftSTOHV, and is initially Bet 1o 5, 



7.2 Printing Fmi^lion Sefinittein 

Thts ttjntWQn PHItVmh'T ca^i bo used to lao^ a1 deFiniliont «( u^er fkrocedureE. In additiori, 
II has. other optiorrs ICr Bsamnrmj Ihe slate oF your LLOSO. f^RtNTOi'T dceEim't evatual« Its irlF^uts. 



Win pit'int oul th^ d^Fit^iti^n ipE th^ EpecitF'^d prtxedur^. IF !lie riBine i^ Dmitled^ il wilF 
assume Ehs' l^^f fgn^^ian thaE wbi del in&d,. ediied^ 6r printed 

PRINTOUT LINE <ttamhi-t^ \POL\ 

Prints, out nniy Ihe specified line in the dstaull prbcedurs. 

PKINTOUT TITl.K -^pntr^-Jutr^ [F{fr\ 

Prints Ihfr Ju£t the lille ol Ihe proLedure gh^^n. IT 1tie input ii omitled, prinis Itre lille Of 
ttia currant delsull pr*cerfurp. TUs is useful tf yOu 'Oisct whith pr(Ke*Jfe It the del*ulJ. 

Prints the titles ol all curen't user procedures Ignores bufifrd procfrdut es |se* Se-ttipiii 

PRINTOtJT PPflCKDURKS {POPR} 

Pi-ihts QLit th^ d^linitinnL al all currently defined itssr procedures. Will nOl prini th* 
defi nil ions of procedures Iti^l ^re bungd [^bs ^e^iKn 10.1} 

PKJ.'VTcnJT.^'/^JlfJ^.^ fpoN\ 

Pnrits I tie names and valaes ol dli iic«r v*|-i«blet 

PRINnnJT AU. JPO/JI 

Does PH{\TOVT PHOCK(M..'RKS anct PRINTnVT NAtfK^. flnoltiBr uwluf cOmmind is 
LINKPRtiVr, wNcti causes a (idling, srmiUr tu Ihp ciglpgl <i( PRINTOVT /iU^ to appear on I tie Hub 
p^Ent#r, It fjiMs an Q^liondL input, b word tn be used as a liltB to n^rrY? 1tic hsfing general cd. 

ptiimovr UN/IPS 

Primt? a Ikfit of savod <Jispt*y turtle »ews. See Seciion 1 5. II. 
PKfNTOUTFfLE 

PRtNTOUT JNDEX 

Set Sectiiori \Q2. 
PBfrJTOUT flSnRKVt/WfON^ 

Pl-itiiti 4t list ol rfl current ahbreviatiOns, and th* nJnrts of ttw pcDCeduret vhith each 
flbbreviales. 
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FRUsTOVT PHtMiTiVm 

Pr mh 9 t«nvkT« lt$t of ill LLOGQ pri-Milives. 

7 j Eraain^ 

Tht 4;Qi«iH9nct fMASf^ will rfrtwve unwanted p<}rEitin& d1 yvur LOfKi' llw inpiilt lo ERUSE 
are n&E evalu^led. The OpIiOi^s ?fV4ii1?b^<! 9^#: 

Cause tht definition ot the toecilied object 10 vanisti. Nolei When you define- Ji functior 
lKin£ W, it checks 1n Lee it there already exists a procedure o( th* Sirne r^jn^e^ and if to, inquires 
whether you want Itie uld deliriiljun M/l&Ed. This Is (c p|-«vefit you (rom accidervtally overwriling 

dllkfiniti&n-; of iurrttiflnS- 

The LLOGO pi-imitiv4 gisre-h tt mpul witi be erased. Ydu mighl use this, fo*' s'k ample, i' yau 
wanted to u^ie s na«¥e uted by LOGO for one Cf y*ur a-ntn luncti&nj, U yOu dc-fme s na>ve using 710 
which cOntHcIs wilh 9 LOGO primitive, it *ill inqijire if you w«it the deltniliion d 1h* primitive to h* 
erased. 

ER/ISE UNK <"^f^t'^r> IERI4 

Eira&B-s lirte <;numb*r^ Ol I(W d«l*uU pfwe^ure. 

L^ibinds all user vsristtat 
l?K/1,ff: PROCKffimFS ^KHP] 

Erases all inleTprelivie user functions. Dofrt t»l sKt*! tSmpHeiiJ Of buried procedures. 
ER/ISR aiMFIi.HD 

Erases all compiled user I unctidhi. 
ER/ISE ALL {ERA] 

Like doing ER/iUf. PftOCKDUftK^, Eff/WKCOHPJJ.^D and ERA^E NJfMES. 
ERASE AfifiRtiVtATlOS ''-r^hhrrvUii^r,-^ 

ErasB-^ th* ^bbrevi^tiort gi^ert ti Inpuf , Daei n^t aCfecE the procedure that Ai sAibTev\stci, 
KHASR FtU </i!r spnpv fEfff } 

See Settion iO.2. in IlLOGD^ DKLETR is a synoivym ol KtinSK FflE, buJ in LLOGOt Ihal 
i^amo I& used r<9r 1h« It^P iurtclicm w4iich d«lete& elernanls trnm lists. 



fiemciwes IrKe from -= /unriinji?. S*r SccNOn S.6. 

ElfA^fK mjHY ^■fuhriinT\ii> [ERR] 

Ihe iuFMilpOns will rw lonaer be bui'ted, For i di^Gussrtn on buried pr-qti^dures, se» SmtiSn 
10.1. 



Delining and filing Funcliana SecKiifi 7,3 
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The ph«l05-flCiH«y *' ("h* ItSP LOGO error Nndling syslem it lo Iry lo be- as t<ir^'mnr\ig ti 

pd-ssiblej ths system will giVd y4u ^n 0pp$rt*jni1/ Fq r«£e]\ier IrDm ^Irrust Bi\y type d error [cvcQpT * 
bug in LiClGfil]. There are two lype^ of errOrs ■whic*' c»n*ttU^; 

8J PA^■i^<^^; ErroB 

If f&r sOme r»95&n, LLOGO C*t^rtol patit the lire you lypect ((or Ely3'"plB^ yftu may hjivft 
typed miiiHakliecl pareriitheEes], th«s r^u^es. 9 parsing, Hjrror. Wh*n Ihia ihappeos. LinOO ^^iH prinl a 
rn'K^'-.TLp^K tflHin^ yHu -rffhy it ^a*. unhflpp/j .'etype 1tnj oFlipndin^ line vl yOU, *ncl lype the editor 
prompi charKter, Veu n^iw have ? <Kirtee (o redeem yourself by correcting (he line — y&u may ust 
any o1 Itve editirvg control ctiarjcter? [wc S^clion 7.1 J When yoij afe £,ah£fied Itial ttie line is 
correct, lype carriage rftlurn, and LLOQO will fCStHne evaluatjcn, using Itie correclsd Una ir^ place Qf 
\he Ons whlcli wm ifl Or'O?. 



tt2 Run T^me Errors 

Whsfi a fun time error Pfcurs, a' metsage will b> prirtt^d. If SKs e* rpr oceurg insi*de « LOGO 
u«er detined lunctiSn, the mB^sn^e i*fiH 5iy tOrrttthphg like: 

iEMll^n !M LIME <HunibcF> OF ^p™=diibe> 

:L1I^E <numb«r> IS : 

j-^rcasrsTi Inr rrnir^ 

11 ttie erriir Secured insida a LOGO pcl^(irV«, the mesi*ae will foOK Mkei 

^DGULDN^T EVALUATE ^had fnrra> 

fBECAlf?lS 

i<reaMin Fur irrai^ 

w tiers ^haA /«rm> i? whjil LLOQO "»**% trying lo evaluate wtien I tie e^rOr Occurred. LbujiHy, i^H wilt 
giy& yOiJ ftrt&u^h irtfofntjtiori tp- fiaure puI where the errOf Occurred, aiUhOugh <hoA fnrm> t^ 
$fl-niBtim^!. (juinformjlive. LfeuaHy, LLOGO will i'mp'^y relurn (& ttnj (Op I* vet loop' when iiitti an error 
accuTi.. htawev'er, if you SKTQ I he varia-ble iERI^HKEAK to- ftPrrnJlhinfl other than A7f^ [Or M/IKE 
't:RfiltRf-:,1K . , , ] 3 rum lim* error- will (Ls-use a LOGO break loop lo he entered aFler |tit metsaae it. 
printed Setting the vsrisbte jUi"^rtWfc'4P!; \9 nort-JV/J. *ill c*aie a LtSP t?yle breskpoinl to dctwr 
wh^n ^n ^hfDf happefiE. {For a detailed dif cushion 0-f bre^kpomls, nee below, 5ec(ion S.3.] You 
cam restme oKireulifrn ol yoyf program Jrom the pOinl al -j^hiicti I tic error otcur'ted, by 
COJVTfMjfiSng with ^Omelhing to be usod in pljir* o1 tNe piete pi data whitt* caused Ihe err&r. If 
the oFrOr w*5i *i^ wrtrfetlned function, ypi> way CnSVTtJ^UH wilti (he narnc o( s (un<;lion wbicti ba& a 
delini(ion. If Tty; crr&r w^j. an uhtjouAd variable, CONTli\l;F. v^ilh a value F&r tti^t •juriahtt. If ttw 
error was a wrong lype OF mpul 10 a LOGO primitivu, CONTiNJJK wilh some sppropfiale v^Iup for 
Irt in^ut Ifl I hat fun,c(ion, et-c. Usually it wifl bs ObwiOus trOm Itw content iw-hat sorl oJ item is 
fequi'ed. Computatkin wMt be resurrcH f^Om *her* the error atcurred, with the reluined iteifl 
sutjsl; i1 uted (Or It* Sng which cau^ent ti>t^ *!tta*. INote: the usual LISP interrijpl h^ridleif fiincHonj 
^i^pect a liat of the new item to tie relurned, white LLtJOtys evpn^d simply the- ilem]. The LISP LOGO 
run-lime error hantfling work"? by utilifinj^ (lie LtSI' erfor inlerrupt fac<liity. [( yuu rffln't lihft Ihs way 
LLOGO ha-fldles arty of the error conditions, yOu dro (I'et le> design your nwn errpr inlBfrupt 
harictlerj,, eil>ier li^ ilSF or in LOOa 



R.3 Breakpoints 

A po-werful debugging, gici Js Ihe ability 1o rauw brfikiwirtts. Stopping ^ prOgrsm; in Ihe 
proce^i of bcin^ cvjl i.jJ*1#£l allows Ihe uier lo evsimine and w&diiy it& slale, 3ndi c^fplofe Ihe- hislory 
Ol rviiilLi»iiofi whrch led up lo Ihe tjn^akpQint. L[3P provide? pucetlent facililies fr^r doing (hii, 
irwiuding autfrrrmlit eeneratiao of breakpOinls when an erfor Kcurs. Whenever LISP slarts lo 
evaluate a form, W fir&t pushes the fo^itt on -t i[3f.^i Irflm » brpjikpQinf one can esramine the stfCK |o 
de! ermine wh?i| for-ms ■wefe in the process of be'tif evaluated, and pertorip evalu^lioni rel stive to a 
parHculfli' itstK frame. LtSP LOGO aKer»ipti to m*k« Ihese fealure^ essrly 3i/*iljl>le to the u&erf (rom 
eilKef LISP or LOGO. Ver-sion? of Ihese breakpoipil funcliOns sirs aho JViilable which can run in fn 
ordinary LlSP, wilh&ul the fetl at the LCiGO er™ir?jhrf*n|. The (ollowing faciHlies a*e jiriiljble lo*- 

C J'T.i'-i r>^ t]"-ftiikpDltTit£: 

The iinful? arB all optional, and are rest evalualsd. Unlets ^*;sttdiri#n> i^ Rsven and 
evaluates tp Nfl., I/KOHRK/JK tauies the uter \a enler a loop where LOGO tommands tan bfr 
typed and Ihe resultr^ prinltfd. This is similar t& the lop level loop ewcapl that 7- t$ printed: a^ a 
^jronpter ^alher than ?i it is very much like repeatedly evalyalinfi PRINT Rl/JV UKt^lflST. Ef 
■"^nn'Mftir^* is present, M ^M be prinled oul up&ri entry 1o Ihe break po-nl. 11 also pnnls the Form in 
1Kb turrcrtt slack frame, which will be Ihe tM lo f.OCnnRK/tK if tilled tuplicifiy by tt»e user. \t Ihe 
bffr^KP'Ci-in! happened because n1 »n prror, the initial slack 1rame will be the one cOntamir-'j Ihe 'otm 
which caused the error WVOHi^f^^K Irles whorevpr fjosLible 1o pnnl out She curr*nt form as LOGO 
tode before H enlers a LOOO brrak pQ<nl. However, Ihe turrthl ■je^sicn is nol always smart enough 
to dislinguish b*<w*ert LISP and lOQO (rarr*fi on Ihe slack, so yOu miEht otcasianally see wh^l look* 
like inlernal LiSP ^artjae^ there. U yOu go up lar enough, you are sure to find the LOGO ccrde. A 
smarlef version could rerOgnize the LE5P frames and ignOri^ th*m. The third input i& a cfclauit value 
tor UfCOnRKAK to return if 11 is Cf>NT{WK4. [See descripliPn df Cfl iVf J iVl'E, below]. Caulidr^r Ih* 
breiifcp&irtl fund ions described m this setliorv use L15Pb C^ITCH »rHt TIfmiF LihlabeHed TUfiGIF^ 
frpm inside a breahpOinl loop arp highly discouraged. 

ir cPmtrol-A it lype<i al any time^even wtiile a program is runninigtil wiJI cawSt an interrupt 
»nd a LOGO brieal^ point will be enter«d^ 

This is like WGOiiHK/lK ejfcepl Ihal the iflOp is a LISP iFW/iVr ^Kl^/li, rfiJf/lDJJJ loop. 
This is ospec:i*IV useful when debuggina a !:.el of LISP Iunc1i(>ns de*i£ned ta run in LOCO, T<J iW^e^s 
your LOGO ■variables and u!*i- functions froin m^dc a LISP break loop, pref'if tN-m wUh a sharp sign 
[VJ. LISP users r*ol*: you can inleract wilh ihis, break losp a-i with Ihe stafwJard LISP liRKAK 
(^unc^ion, esfcept thai il ks sel up Ifl allow use of Ihe slack hacking functions described below. H tP is 
typed, or iCOiVrtf^VF) invoked, Ihe ^rriurn wi<hp> will be the value oi the calt to USPHKK/iK. 

As in LISPj aH typffd 4l any tlifle will interrupt And tsvse a LISP breaXpOint to b* onlerod. 



Errar Kandlirg anrt nehmgai^ig ' Sectljin 8.3 
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[f ihi* -j^i^ljle ht nut iVN, *h*n a run lir™ error happsns, f^OHRK/iK will bt tsHedl 
■aijloTriitltaHy, This ^lue? you ? char,ce Id Jind out wHaI we-nl wr&n^, an?l rp^ciJver ty COJVTJj'VL'KIng 
Ufith ji nQw piece c>F da la lo replace t*ve ont Ihal cius^'^ t1i<? prr^r, t| i? iNli^H/ b«I Id fif/L. A& in 
I ILOQOii Itie (uncticirt Ot-^libV will aI^O change- wheSher breakpoinli octur qn flPiflrs, 

Lih« i^JNti^JKK.^K', fvcfpt Ihal if -set la satnethlng alhnr Fh^n J^f}^, wPvn wi error happens, 
USPHRKAK ra.tKsi' Ihsrt I^COirHK^^ '^i|3 bo calFed. [nilially seMn WfL 

The loJkuwftig hjnctiflf*s csn be- cslled From insi-de ^ bre^hpoinl \o (vamlfic ^^ wshlpulate the stithr 

VP 

fiJ^ve^ I Fie breakpoint up- one frfrne ^n Ihe a.tie.\ pr'^nFingj q^vF thv l^rin ^ihicFi ^9^ pbC^ul Ip 
be evilualed in IFiaF Frafne. This will b* lh* f5"n which callecf Fhe 6ne whitb was FasF typed ouF by 
any ol tF^e funchpn^ inrntion«d rii Ifii^ ^ectidn, EvalualiDn now laikei p\x:t \t\ th« ^«w st^^k tw ^rj^. 
This iTwanrs thai al^ local and inptjF vaifJ»F}]ea uill hwoe^ tF>e vslufrs (hty d<d when IhaT lirin ■*« abfiul 
to Ix evalurited. However, side eFlecFs luch as ^ssignfu^nF p4 global variables ^re fiot UndOhtA. 
Frances *rfr T^umbeicd tOr the user's c&nvenience, From increasing yp Ip tflj> l^vfL 

Geres <niifnht^f frames up Ihe ttaet lik^ dqin^ fPf <:B»PTfr(T> linifl?, Thfi tntumfiffl^ may ba 
negalive, in which c^^v,. the breakp4iM ps rndvsd d4wn Ihe sFapt raFFi^r ih^n up, 

Goas U^ the ild^k Until a call \6 Ihe function whAse name is ^■Dnt> i$ fQund, 

Goei yp Fh$ jF^ck until (he cnnm^ffoth caH lo ^al*m> Js fciund. Searches ttownward for the 
■^numbcr^th call ta FF>e spetlFied fynction it <riiimAflr> i& ne£»tivr, 

LihC £/P, Bifcepl 1hd il proceeds dawn Ihe itaC^ i4\s|t*d at up, Bc^th Imputs Vt optiO'lldl, and 
defaulF «$ F(?f L'Pi e^cepl Ihal *jim mfcftr* deFauHs 1D -1 instead oF *l. \t <nuTnf\r.r> I? jiven it Is 
equivalent Id t/P ..,. f-^ntirafirr>J, 

Acc?pT& inputs -as dges t^P^ bul instead of nwvlng Ihe ^rcikpqint up th<; ^I^Ck fo th& 
de&ired Fra«ne, all frames between tht ■twrrtnl one and |he one specified are printed out. This 
funclipn i$ g44d Fivir getting a ciuick view <>\ the stack in the immedritte vrrmity of Ihe; brcti^pOint. 
Thg breiakpAifil remains in tFw sdme frame a± b^For^. Thg Ew^ inputs are DpIiDnaL and de^aull as For 
t/P. 



Like FRiNTVF, »sfCept I*i9t the inpuli sre mlerprfrtect »c l&r iX>WN walhtr Ihan ts. lor UP, 

Eh>4l is, ■! prinU frame-s goii^ do^n tli^ ^t^ck, 

BX/T *;f«itrrt-t.wJiMT> 

Catjs-ei tlifr tushftnl 5-fach frame 1o relurn wrfh th* vdlw^ '^i^lurn-iufu^^. That i:^ Itrc 
coffiputatlort tcnifinuo's a^ tf Ihe form in the €Mfr*nl irprnc had relurrwd wilh '^rr.ia.rn-vnla.i'y, Th« 
input 1$ epiiorval, and (felaulti to Aff/^ 

Cau3.fl5 1h* Irame of ths DrJaihillyf ihv&lie^ broahpeinl to return with th* s pet if led va^uo. 
The inpul is. op^cmsl. \he COSTINUK 1o relurn a^ nrST** ittm o* dslp IrOn inakJe a<i errnf hffiskFKunlij 
lor iri^tarve a new fuoctioh. rtarne Iq use in pIkb of ont wtiich 4^a± urtdelini?d, Nete thai in. nrany 
wtuatioini, for enamjile tiom a user-invoked breakpoint at Irom an ^rr&r breakpfiin! whi-ch eifpetia 
an item to be returned as- line yatue o< the lorm which caused Ihe error, if you tiivtn'l movrd the- 
'brc^kpeifil arourd Ihe :,tacK, COI^CH^UH wiH be Idenlicil fa K\tT. H ff* inpuf lo COiVTJ.'VL'E 13. 
cmiUed, fhe cfclaull rofurn value spetified b/ a th«rd mpol lo ^.fif'fJflfi/lK or l/JCnilRE/iK will be 
returned 41? the value of ttie treaKpchnl. ]l no ^gch dtrlau^t return valve vna^ given, .\Jr wilF br 
rtlurned. JfP can alio he used lo r*lvrn rmii fh? breakpcinl, ju^C a^ m a LISP br*takp&int r+jte 
that Ihis worhi ^ bil dilferenfly UHfh CifNTTNfJE in tllOOO S!i w^iC^ Ihe breakpoitil relurnsj 
enecuti&n tSr^Nrvue from ejractly the ppint »| ^htch ir vis intarrup-ted ami not beeinntnj witii the 
nevt lin« 0' tMJfr, 



Here's tn oxairtple: 



^SUNQtNC ASrSTEM NAME 

T 

^T9 SCREirtf iff 

>I If r.'V-S THE,W WTPVT ^UfiBOUNI> 

>Z OifTf't/r SCHKWUP :f<f'l 

^REWUP DEriNEB 
tSCRFMbP J 

jERMm IM LIKE 1 OF ^FICVVUP 
3LTNE 1 \5[ IP :ISf-fl- THEH OUTPUT lUMHOUND 
iiUHBOUNn 13 AH UMHflllNfl VWilflEllE 
^iBRliAHl'fllHT FRAME B; lUIJBflLfWU 

a 



iBHEAHFDJNT FRAKE 6: :JKinUHD 



tAsGure LOGO break happens! 
Ewhen an ^ttai otcur;! 



lOefine our (esli^ (>rOtedure.E 

ICpunt do«n to 0, thrnt 

Fevat variable which tw no v^furt 



IFrapne D ii ihf vttitblt. Zvat wieI 
•working On Ihit when we bombedl 
!We tan do any comnandl 
E^hjle in |lie breakpoint.! 
IGoing up B Uawe. VNROUFiiy. 

rwaa Ihe inp4jt to OVTPbT. 
[jjoing down a irame,! 



Error Handling and Del>itggiii^ 



^tion OLB 



USP LOfiG MEMD 



?>9E^ 



Mnxch fl. 1375 



■BR&^KPfflNT Pn^ME ti SCftEVtUP iN-3 

1 

iBREAHPQIWT FHAKE Iff; STFIKWUP :lf-l 

1 

SCHEWED 



IwB BrrivB at recursive invticalidn! 
Iwhe^fr :N had! the vain* 1! 

13f we rise p^sl Z calk to ^'CAt;!^^^^ 

Utial SCfiKtrU/' of 2 15 ; 

No return fhc value 'SCR^FUfl! 

fjincT 9i1l fhfl p'C-viOus invflc^liOn^ ! 
M SCRKWl'P relurn whth I he value! 
f-SCI^HlVEIi and WB ar« »\ top lovcl! 
[W^sn^l Ehsl tun?'. 



fl.4 Wron^ Number pf In puis Errors 

&lrt« LOGO ■fjynfa* rij-quLrr;^ thdl thf p'tiTier know how many Irtpy^tj # fyrtt^lpFi r^ciutfe^fj pn?! 

LLCKjO p-arses- yOur inpul as ytHJ lype it in, BrrArs in^v be ^pneraleid' if ydu ctiinge the r>urT«b«r ol 
hputs a funcdpn bkcr- by rc^tf-ning 1hc fijr-clion, flr tfjf calling FD!TTiTlE. CsH^ lo (lia! furtclion 
which yoj lyp^d ti'cvicusly ^rc row incOrrB*;Mv parsed, LLOGO *ill zihh mosi MCu*renMS of thit 
when the furictir^n i^ cS'lled, and print a msissge liheL 

iHEPftRSlNG LEHE -^numbw? DF <pracHi.iire> AS: <ww |ifl«e> 

and a) tempi it> raiover. LLDGO always altampts 10 reporsB a line which canned a wrong nuinber of 
\nfHf\,$ ti-r&r, It h n^^ alw^s po^sitlt t(j Win, howfrvifti-^a* s«de <!'(i{jtt^ majf h^vc qti;yri-ft^l bt'ore I he 
erfOr was detected. 

Versions of LLOOO runmng in SlBC^ LtSi' [LLSi^s with the capabitil/ ^^ dynamically 
»ll5Catrr^ iiCii'aRfrl h*^e t..p*tial hai^lcT^ for E*rt>SS-*> t^HctlOr interrupts. \t It decidcS yOU Kjrve U50tt 
Ido much fildrage space pf a particular type, or too muich Ll»ck space, it will sfpp and pcli1e3y ash iP 
yog >iV4sh moft Ic ht Kld^d. \t yant ^eo tlht$fr [Tij«';i lona r«pc»ft!d rt\»f\y tln^-t m • fho* t £par^ -of limt 
wtiil? running vrv prOgr^nn you should ^'^^ ieriou? considerBliOJi lo fhtr pOssibilily Shat yOur 
program is doing inlinite Cp^-I^mg or recur&intg i^finilely. 



fl.6 OthEr DE?t»tgging Fjci!i!ifs 

The staridard LISP TR/iCK package mai/ be used to trace LLOQO primitfewes df uar 
functtons. The trH-t^r i^ rtpt normally r#$ident, ^yt i± loaded m when you fir$t r^l^i'^nce it. See the 
LtSP' manual- For dslaUs On the synfair oE \h u^e and Ihs various OpttOn^ availati-lBu No LOCC &tep by 
siep execution mitn'pttisr oomparable t-o the 1 1 LOGO STF^P Facility evista, bul stepping packages 
wrJtleni for LISP can be used in cOnjuncliCm with LLPS), 



<k7 tnteracl ion wjr h LISP 

En detiuaaifie fLjhftsOfvs wriiren in L15P for us* in LLOQOl, tt is &f!*n wstful To- be able Eo 
Switch bflch ind forth be! ween LOGO and LiSP lofi level Ifleps. You can leawe Ihe LOGO top level 
locp flnd tTiler a LESP HH/Hi-KVAi.-t'kfXf Kop by UEing the LLODO fu»*Llian UUP. From Ihrs m&^e, 
ei{€cutm_a (WCO) [rflrr^mber lo lype !hE parenlheses, yaa're m USP!} 'Will return 1& LOGO. Typir*g 
cCnlrftl-uparrow [«/^] aE pnv lime will c*uSc <<n mlnrrupl: sr.d ti^jlcti workJii you w»ll enter U$P If 
¥(HI tyfwd Art (r&m LOGO, or enler LOQO iF ynu l/ped i1 frpm LfSP, The LISP loop givES you aiicess 
to alE inltrnal LLOGO functions and global variables, wNch are nnrrttalily 'injti;c'e$frble fr^iri LOGO s'lXe 
they are on a dNOere^t (j4j*if*-*y, ILOGO prirnitives ^nd ayalBm variables are on hotlt -abacrays, so 
fhry uriir bs accEi^^ibl? Frorvi bnlh lES-P and LQ430, bull LOQO •■^Ci' tgn^h^n^ ^nd vfin^bie; are 4n Itv 
LOGO obarra/ only. Tl-iet tttsragter ^hjirp ^i^n [>'] ■; sn frbarrav-s-wikhing rwacroi Id scces* IjOQO 
user funtllDrks anct variables fr^m the LISP locp, preFiK Eheitt wjitht * ihirf^ ^ign. 
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LI^P LQCO coMpile^s 3 LQQO f.DUTCd prt^ram inl4 LIEP »rid i1 is. -slDre-d inlerriaHy only as 
L[SP eodp. Sin-c Ihis rc Ihe c^st. The LOGO user h*s the tifUbilrty Qt utinfl the LfSP iionipikf 
directly an hii LOGO pTogfams^ wvi Dbt^in a^ subst^anlia! g3\r, in elFiciency, once lii& prograrvi^ are 
IhtOroughiy debuggEd. Lt$P LOGO prOvidES an inlerhcs 1* Ihe LtSP campilHr whitli should make it 
Lirtnocpssary ^0^- ti^e usbt 1o *Orry atrtui irtteTj^^Fng i^ilh * s^pjirBt* prOgrrtrti. 

Tft cftmpila all 0(1 Ihe Funcli&ns currently in the wdrkspacff, Ihe functpOn COMP/LR is 
flvailsb^fr, [This doe^ not inchude buried proLcdures — m S^tl^nn 10.1.] It «Hpeck one word a-s 
in^put, fe name- Ihe File which will cflnlain tl*w cflripiled cOdw. A secflnd OphOnal input can specily a list 
□I detlaraliorvs lo tt^E LISP compiler. For BKarnplei 

CGMPfLK FOO [I)KCL/}RFr {FIXNl/M :fNTFGEfiV/mi/lIiT.Fr}] 

Ih* mrWfS oMhj? fyndi&nj whith jr-f t>eirfi tflmpiled will hp; print fd flul. The Cfl.*fPfJ..P rurwlisn will 
Elart up Ihe cdn* pjl ati-cm ai^ then r^lurn. 11 wiJH print ano-lher mes.LaQe v^hen the compilat an is 
finisiifrd. A t^mporarj^ oulput file ^nimed .WX^ft (K'TPUT] •mi\\\ hi wnlten On the turr*nt di rettery 
and (IftM&ii aFter the ratr^pilalion m compleie. The a'-hlpcit tile will hn-^t m. i\tfA hf)fr-«^ the input to 
C0^1F1L^'I^ arid second Frje nanne >7iSL [En Ihe MIATtC^ ir^pl-einenlstioHK the lempof^ry lile will be 
n^rtied tngo na.tfiiLt Aiici pbeed in the currcp^t directdfy. The culpLit fite .will appear in the worKing 
diroflery, wilh Pne nanae, the inpul [o CO^tPttM,^ Smca (he LIBP c*ii>piler musl be called up as. a 
separate progr^AV, be ^jfelul about jnlerruplmg the (jOVPILR Funclian beFore \l is CJrii&hed [For 
inE.1arcB, by Af^] ar yOu will nOl tind yOufself \n LLQGO airayrmOre. 

Th? LOrO COMPfl-F Func1i[>ri supplier declaration; lor LC[^ primilives- Tbeae should be 
suftkienl to torripile noii LQCQ prpgfarr^ and Ihe user nieed not supply any himselt. Son^ Ol tihe 
declarations ■include LISP rnacr&s which rgplsc* 'ls'']^ to LOGO primilivcs with caMs t* Ihtir '^^tcr 
LISP c[>uril«t parti for elFkitency, and ^nme opIirvtizatiDn \i done. For safely''^ ^ake, all variables «re 
aulotnalntaHy dfletarfrd SPHCl/Hr- I4pwevftr, thfr *.i5p1^ittlt»tftd uscr is triyr- to Irickrde OFCI./ftiFt to 
tj'!\'SFKCt/Il. input or IocjI ua«ri^t1e^ wtiich he knows will not be relerenced globally, or pr{3vide 
declaTati&ns whi'ch will m?kp u^e ftf the laEl-arithmelic LISP tOrjipiJar. 

Ta IfSad a cOfl>piled file inl* LLOGOj say rtF.'/Ttl'iF-' (/..<-; ■:Haiwr»> f^&L This will lead *ll the 
compiled lurvctian^ which were complted by COMPfLE <tiatrti-\ afud also f«&l:ore the values dt 
variables Ihat were defined at that lirne. Ihe names el c*rr*pi'ed 'unclio-riB will be kep! On a lisl calfcd 
:CO^tPff^KP *nrt no! on -XlOyTI^filTS- for (Jehu^elna purpoiiet, ya^J wight wanl lo read in both Ihe 
cPrvtpiled and irvterpreted definilienE of the sanv lunclians^ and ybu can use the Fur^cti&ns 
FWSltCDitPtLHD {Fl£] and FWlilttm'KfiPRKTFJ} \FU\ lit &wikh back arid fftrlh betwB*n 
OOhrtpil^d »nd int^rpr^l^d fl^firilFi9h±. 

A few warriing^ about corvtpiling LOt^ procedure^: Fir^t, rertvember Ihal LCIQQ syrilax 
requires Ihal it be knOwn haw maniy inputs » luncliOn eifpects, before a decisis*! can be made as I* 
hPw to parse ss lir» of LQQQ code, il, when defirung a procedure, ynu incliude a call lo a pfpcedure 
vhich IS nOT yet delined, parsing is delayed unlil run linne [see Sedi&n 6 ard SecliPn 3.2 ol \h\i 
memo f^r' 'mtyt^ -d^tA^I^], The- f^rn^il^r, of tOvr^e, (Jtriii^F {lo anything r«;#:^h4|jle u^^lh an ^jnparsed 
line of LOQO code, so aH parsing -must be conipleled by Ihe Ume Ihe delini'l:«Dr d1 any procedure is 
tCmpiled, The CttMPfLH functiOr^ altempl? tP inake: su^e this ie |he cas-e, Ih^ref^r^j il i^ ^n *rrpr \q 
alteinpt to compile a prnceduFe which contains a call 1d a procedwe which \i not a LQQp primilivB 
arkd has r^t yet b^en deFined. 



Al^O, il mifil b? remeflifterecf thai compilation Of UOOO prDceduf*s, lifee (hose ol 11 SP, k not 
"foalfiroaf. [t i$ not fltways the case Ihal a pratedtwe- which i-mris cOrrocHy wtwn interpreled, will be 
guaranUpd fo run corredly w*hen cofnpiied. $fl1-rnodi(yir^ prOcerfores, weird control tlrutturps, ^mI 
ir gEneral prmedurts whith dcpcr^ hBav'ly on Mai*itairwnj 1he dynamic anvirOnment of Ihe 
irterpretir" may l^il (^ tumpife tPrretlly w^thoul modifieatpen, 
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Scttign 1ft UMh£ FiJfihLVOOO: 



A fMfr !ip*f:if Ration on [TS has. (our compose nti. Each fjlg fes n-aired by t'rf'fl V&TtI?, of up to 
six chiracteri each, a devifg (^ItiOfI ^ilwjys. OSK], :inrl ^i direttoty name [uEually the same a^ (+ie 
user's- rvame]. ¥0*11 can refer to -a File if^ LOGO by u^inn ^nywhrrr- Irorn to 4 wciT^Jt. 3f you leave duI' 
|h* rtamfr Allogitl^fcr', It wKI be asiLwied tlial youi a^e refeTrjng \u Iho l^sT iil* ri»rr*c mcrtlionetf. On* 
wCrd will bei I'a^wn 41^ |h? tir^i File i^i^mr, ^nd the itttanti will defaulE tD >p wivcti nwan; the highest 
numbered iecor^d Hie name whith currgt^Hy emsls i' yOu srt T*sclin£, of one hijher if yoiJ are 
writing. Two wOrd? wMl be tai^en |i$ Ihft tii^O fil? name*, and the di'ecfnry and devicE will be 
delaulted. 11 three 'n^mes i>rff giv^nk, the third will be assumed as Ihe directur/ namp, and Ibe device 
wiM h# n?K. ]f fomf worda are gi^^np I he third is device and (fturlh is the dircclOry, Ht^t ar^ sons* 
exf^mple^i 

(Assumo lh?t the cunremt iwsr hji*!* it £SC^ and FOO 3 is Ihe hifthest niMHibefed file with FOO as its 
lirsl fij^nfltne] 

LOQO ITS t*'rtl!Klrt2> ^:dev>:^dir>Ej 



5 /l I' fi Ff}0 foo > mK\ K:^Ci / fftO +/ 

mUUtHhf-': ffiO W.^K liK\-tiY ffiO H/\fi nSKTltKNRVi 

READHf.K F(H} liAK DSK HHMiV f(K) Rfift (iSK.liFfiRY: 

E«e E«clic>Ti 1Z,Z jind SrrtiOn \^ lor ihlormatlan aboul lile specif iri:«tion& on the MJLttCS 
«nd TEPfiO ifflislsiri*ntalion&. File specificatifins. 3*0 Kccplcd t>y LOGO in I he same format as on ITSp 
M il ma/ nOl b& nacessary to cUsngt an/ cede ta run on other ifflpleinentali!jn5. 

10.1 Saving and Hcidini; Fil't^-s- 

There jre twO *ays el BlOriflg LOGO p+O^rthrts an |he dish l^f i^ltr use. To stcre (he 
COnttnH at the cvr^ent work^pate [^11 u^er funthDna B¥\d variables currently delined] -On Iht ^fK^ in 
the Form of LOOOsaur-ce cftde, ute S/ii'K. W e-vpuzH ?s inpul d fit* ■speeihestion, ai diteutsed abwe. 
TJis Fife crsAte-d u^ill tonlain Ihe tonleriti o( the user's workspace, Funcli&n cte-FmitiOr*! flnd UflKEs 
for v^rbabFef, t^'^cHy in I he loi-m thit he would see iF he did a PRf STOUT /lU^ 

Workspjicc^ c^i^ ^I^h;) be j^^vedl in IfSP Farcnal, b& they are represented i'niernally' by LOGO. 
Thi£ is atcDfflplished by the funclion WFITR which lake? ils inpul? jin d5cj ^^I'B, Allhou^h the File 
created will rvDl be &a prelly lo lot* at if yQv pnrit i1, uiiflfl, iFfffrK profiuces files which are 
tOnsiderabiy Ifl^ler tc^ rslojid, flinf* the pKojram does not have lo he feparsed. Far lorrg-lcrm 
slorage 0I pfograms, hewevgf, 11 is recftmrricndcid thai you \Kt $A\'V. rji'ihftr than WRITE. Changes 
Irt tl-itf implehnentalion ol LtSP LOGO may result ir* chanEJi^ Ihs inSernal Idrrvial OS LOGO prQErami:, in 
whl'ch cji^iC:, 'iCes ^rc^itr^ by WRITK WDuid nDl remain compaliUe, but files created by 5^V^ wCulH 
remain sci. 

To reload a File tram Ihe dish, wsb the FurcEifln REAI^t'lLE IRF). Thii «ceph a staridard 
file speciFicalior*, and reads M l^^ p'inling Ihai rjinc ol (hp lil*. fiK,^nFilK doei nut care whether 
th^ FiId i? in SHll'''iFfd or IT^ITteT^ form. IF the lile was created by S/IVK, lines «1 cOidc wiLl be ptifiled 



out M They CDfnt ,n Irom Ihe disk, for wririen (-lei, nniy \hv nsn\et of fLpnttlcns and values o.f 
variable* will appear. It yam |*f annoyed aE all fhfs Oulpul, y&u c»n 4hut || up with r,W. LOUO wfil 
return wIEh a cju&?tiCin mark when the laading ia -cijftiplfrt*, 

It k Dft«ii cflrvenienl to im,\ s 7et of furtcllQiis *S a ■padnflgf" or "subsy-^tem" Fqc 
iriitaner, yOu may have a s^l cjf ydur FavorH* fm^ctioni which you pIkc in your irvJIialijati&Ti file, or 
* ?«t Of lufidions dfr^iEHBd for a ipecHie p^rp^se. When t^is i; the ca^e, il is .nconvpnlBn! lo have 
dll the&e funet»0ri5 wr^lten out *he-n yOu are working on ?ddrtiOnal prGiedur'Rs, cr t^ave to see thdf 
delinilicrs, wt^en you £fei a PfiYA'rRf/r yi/.L Thj.! 15, *r» would hke ii mdhod of havine the package 
Oi runclioni avsrl^lg. bul net eonairlfrred m pari □) Ihe *flrk5p?«ce by cerlain commiinds.. You can do 
Ihiis by usim? Ihe function J?(;K>'. It lakei tjnevilu^tcd prcKedtre tian-<yri 35 input, amd wkIi asTiyrc Ihat 
Itw function is iflF^r^d by Ihe (oI'Dwins cOrnmar^dt: PRiNTftift" FHiK^KDHRKfi Pff/M'OCT /Tl / 

*'Hrvn)(;r rvr/.jis, Kifyis>; pnocKOimis, fmask all savk. jfrite *nd compilk. otherw,?* 

Ihe (unctiDfi (£ u^ia1|icctad^ and can h* invoked^ pfinled, edited, stc. .A lis! d1 the fi*»riie5 d buned 
pFoce^Jure^ js kept as (ho value 6( Ihe u^nsblc jM/H/KD. fi(;WV ^/.^ will iiUfiV all CUrrentlv 
defined pc o^erJures, and t^fi/iSK flC'Hl' will undo the c<fBct of a Bl/lfF. 

10.:? Olher Ft3 e C^miimids 

PRINTW-'T Ftt.K {PGFl wIN ^finl oul the contents of * Mb. KRnSK FILE wiM cause tho 

spec if red 'lie to vamiah |ThiC; h^r, s gaiety check Id mti-v s-ure you don't dff inylhinE you'll be sorrjf 
about J. Ttiese Eik« f.'le n^ipcji as above, escepE that if only One input \^ g.lvon to ^fi"/lS^' it dfrF*ults 
tp <j the l*a^t numbered j«tflnd ^ile name, ajain for iifaly reasons. PF!i\TOL'T Ii\DEX [POt] will 
prinl out aii Ihe MFe names in Ihe dircdory spetified by one wflrd. L'Sl; will chaise the irame Of the 
dtfauK direclciry. 
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SrjiEEE^n tl. tlirferFRC^s bel ween ] [LOCO jin«ILLOCO 



LISP LOQO VB^ Ciriginalfy wrilten Ift bB cOmpalitle wilh CiOGQ, a version of LOCO written in 
I^DPIO fl-ssefflbifiif l*n^UJ*j*. Thsr* rt(v# txish *■ vtrsiOn l^■^ LLUGO which wb bePieve Id he 
'semanlicaliy comp;ilible" wilh Ihp POP 1 1 veriipA By fhis ^* mc^n Ih^t |hc vOtabulsry i-j the &ame 
— ^riy primil ivQ in 1 1 LOGO alsfi eyittt in LLpGO and will (hopeiuit/J ha\ift t^* sam^ ir^^mnf,, LlOGO 
in (ael hiaa many pFimiSivts i*fhi<h n^Jij nof cri^l in illCKjOn as well a-t cPfering. the user «CEts to llw 
flill iiapjib-iliffes &f LISP. There ^ire suttlariMa! diffefencei bel*sen ILClGO artd ] MOf^ with r^p^ard 
|4 Flic ^y^lenns and error handtirrg, arnd laiie^hat leiL sifljfilantial clil'Irrpnrc? In Ihp cdit^r^ 1ur|le arid 
music packaftei. TTheiit ire d^strpbi^d in fJ^tml in ofhcr s«c1i(Sr*s *E Ihis dficumenL There are alio are 
severdl leas suh-stanfial dilfprcrKiei^ m^i rpenimneA in the preceding ditcus-Liontf ^^^'^ what follow* h 
sn ^tternpt td pfdvide a reasonably caftiplete lisl o-f ih^ km>wliM.J(^e thai »n i^iipvrifrnced IILQUC u^er 
would need to ui* LLOGO. 

In LI LOGO, I he dOubb quate character " is. lued lo ip^^ify thj| 1hfr tt^f!^ f^llowif^ it 'if nfrt 
1o be evalusted- 

It 1$ lihg LCSP"? single quelle, B^tcept tKat it also a'tect-s the LOGO re^er^* de.fi iiDn 4ibout when la 
step includrng successis^e chidrraLteri in fattMng the nttnt a\ an atom, jn 

"fPRISr :FOfi*A 

the pigs sign is a fieFK^rjUcic th5f*tt«r'; It ^i^nsli (tw end sf the alAm if 00 just as il there was a 
space fonftwing -.FfiO. However, following a dkjuble qwte, the only itpscAto^ chiirAClert rerdgnPEfrJ 
are ipace, c*^f»aet Ttlum, a^rf squ.are brackeils. Thus, in lILOGOv 

•rPRf\T -FfJCJ*.T 
TOO +3 

[n LLOGO, the Liser may mt the LISP siflgle quetc to i-pBcify Ihat an bIot* Sr parenthesized 
(iil fallawing. the smgle Quole is not lo be e^alu^a^ed, The prettncc 0l tNt singlp quOlo dees nOl 
Chan^^ (ht **y LLOGO dtcicles when an alftm erids. [n LLOGOv 

'*PfifST'f''00*J 

jtHE IHPUT TDO TD ¥ 13 IIF TKE WPflfJI] TYPE 

because the plus sign i$ ^Eill a $ep»r'4|Q<i' c^nrseltr LLOGO uSas Ihe [fcuble quotes as CLQCO doEsi 
they arc; alwnys nplched. [I D'He s-expressidn ^alom or li^t> occurs in belween double qu9lC3, H if 
qubled. If more ttian on^ oceur?, th^ ii'^l Cpnljihiin^ them h quOled. The cOrre&penderKe b^lwieen 
LLOGO double qucited expressions and Ll^P s-eKpressiar^ h as fpllQW^: 

*" --> mi 

$^ijari> brachE^ls in I ILOGO specify (tuoted I>l1e,. P^renlheses a*e never used around lisls. 
a& in L15P, but are only used |q de'litnt forips, ILOGO rotOfiniies square bricksls as w*ll as LtSP't 



pfirenthe^cs in rftfrKjlif*E list^. The diFlerence betwEen brackelB Bnd parenlhes-es in LLOCO i* thjl tht 
brine keH always denole ^i-sl co-fistdnlE. and nol Hcrms, sfid Jhat the au\tr ltv«l af bi'KkelS ti imfulicitly 
quQied; 

Thflre is » minor pi N all m tht currerit hmpttripnlalian: npte Ihit li^p l^^el pjwentNiMS jititplicltl^ 
4U<?t& I he li^^ inlerjAr OrsB do riOl. This dcies tydE a^w^yi work, far iFularhce when u&ing /7(Jnf one 
may ^ypett mtftrifli' li-sls t\$0 1(5 remsiYi unewplusi'Fdi 

?PfrJ,VT [Pfif\T [fOO K^ffJl "> fPfllNF YPJ?l/Vr CFf© ff,^llJI> 

PRINT (FDD ahn} 

?m;N iPRfNT IFOf) iJflHi] !.-> fflt'/V '(FHl^ ffOO BAR})) 

prin.t'E I lie value- 0' I he fuoction FOO applied to inpul BAR. 

Square- bracK^I^ in JlLpCO als& shara wilh dr?uble quotE-s the prtrperly de&cribed ab{?VE cf 
affecting the LOQQ reader'? ^J^ciaion pn e-ndi*>£ the njfi*? fli <*1flm5, Wftlhrn f squ^rp br?cl!-c1c<J Mst i(1 
i JLOQOi an alcm iv ternnnaled only hy a ^pace, carriage relurn or braekeL This property ia nol true 
of -.^vniu brsckot'* 1*1 LLOGO. In LLOQO, [PEJW+JJb a lisl cOnlamin§ Ihree elajnenls, bul in ilLOQQ, it 
contains only one elemenl. 

String qwOlirig »n LLOQO is. accOmptished u^ing Ihe dtjUar -sign charsc1*r^ $. LLOOO will treat 
anylhi^g appearing belviii^En dcllai 'Jgnt literally. v^i1h i.^iLfi\ eharact-era iif/a\ti ol any special 
(ne^ning. Wilhin surh a string, f'rt'O cOnt.ec.ulwe doHar S'^gns. ^*;il| be inlerpreled as 3 single dollar srgn. 
SQi SSSS twouIcI be the iioni whose name ii • smgl* d(3li»r iign. iJ is the cmpf-y word. ftubOLft, 
edilins and iriterfupl ch:)r'*ete^¥ cinnot h<e qUQlod ii^ l'h<$ manner, Use l^e ^^CTff tunclr.Qn qI LTSP i'f 
-you really need Iherm. 

The tharflcter sharp sign ("f"J in II LOGO is used k a prefix macro character which Eakes 
on« input whi^li mu$t b« a wat<j, and eite«:y1'?± i-t m i pirocedure. jl i$ v^ed wl-'^r^ f>ne wd<ib tp u&f 
t v^eird nani« for a prOcedurE, or a nams already used by the ^yslem. Sharp sign is used as an 
9^cap« la Cdtl that prOCcdur*. Tllufc, a prtKcd^r* deriiflfrd i" H I OfiO by IT^ 'PPfNT . . . would be 
t^t^d by f"f^HtiVl, TO '-J , . . ■•vui^d be called by r"3\. ek. In LLOGO, sharp sign i^ used ffs ;i mscra 
character which causes 1he neKl i-evpre^stDn to be irKlerned as if it wef? re^ad in LISP it ynti are in 
LOGO, Of **. if rt w^is rwMl by LOGO H yeu jirc in LtSP. If yOu are in itie LLSP mode of LlOGJO Jrid 
war^t to access your LOGO variables, you can ^3^ trFOO, etc. The conflict 'may be changed in t tie 
nfr-ir futurt by flltei-irtg LISP LOGO'5 mjcro chsractcr 10 On* thjil dOB5 nst conilict Willi 11L0C50^ 
Suse.e&tiort!^ \M-elcqmB. 

The BoDtean [logical] can$tanti In ILLOI^ are TRVF sfld FAI^F, while in LLI^[K>, Ihey are 
T and f^lL as in LtSP. 

The llLOQQ funcEiun IMVEL, whicli returns tfw current procedure depths is nol 

Jftlfile' married, 

The char acter i in 1 ILOGO ii IrEaled as a ^icacr-D "'the va'ue Of ...". i1 A is b*und lO B- ar^d B t& 
bound to C, then '.:/) i& C. In LLOGO; vanablp^ set by MMK arc ius! LISP ^tomj bfr&inrBng ^fltti the 
chjii'scter '-, so t;A wlJI l^ th*- vjlue cf the vtri^ljle S*t i?y MAf(f- ":A' ^ whatrvirr^., etc. We are 
se-riously cOr*siderHng changing this, eliminaling t*>F InrO-Tp^tibilily. The prc^cTil setup [-erquii-'es 
MAKK to do an esfpenEtve E\F(.ODK on Itw vanatle nsme, in order lo create the word which 
begiri-:: wtfh a COton, 

LLOOO evpectfi to find only one lorm i>nstde parenlhases^ construcls like 
BiftenncEj between ITUICB ird LUW3 Suction 11 
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are prOhibiled. ] ILQQO ^EIow& nort thstk one- lorm inside par^hlS^fi^i Vfiiiit tultin reilfictiori^, 

Thtfi 1 J LOGO pfcif«dkife TKXT, which r«lufri$ * M o* luls which »f« thfr linc^ ol * 
pr&cpdure whose nafne is- givEn as mpul^ is rvot implem&nSed in LLOGO- However, you can actess I he 
defintlion of d fiinttio-n in its parHct LISI' tottn pn tht propei't)^ l>$1 [CDR] Oi th^ ^lonv 

LJLOGO Ltrderslflrtda twfl Mmraent cortvthtiont; LlSP't coi\<JtnY\Qi-i Qt U«slir^ as a tomirtcnt 
anylhirvg belvi^een .a Een/ucolon and the neid carriage ftlurft, and LOOT^ n-f treating as a tore me nt 
•fvyltiirhg in bri'wccn incliirTiiiliOn pOmls [the BKclamstiftn points (plkI be matched, and ccmmerrts 
can be f ontihirtd pa^l Iht frhd qI Ihe linel Ariylhing ^Hnr cxdjirnition poml-s fln a Hirts i? i^nOrsd. 

I ILOQO Forp'n^ jfe di-vid^d rnto two c ategjCM ie± : ttw±^ th^E oajt^gl [['eturn * vilue] and tha^id 
Mwliith do nol. In LlOGO, as m LISf*, <?w'ery iomi relurns * vjlue. To jimutsrc 13 LOGO and CLOGO in 
thij reaped, fls fl 5peci?l h*rK, iorrns ^hich relurfi a qufl-!.l»On m*rk do not hav* Iheiir values prinlEd 
by LLOGQ's lop level FunctliorL htowever^ LLOGO cannat cakh Ihe erf or at ^uch t fqritii hiding inside 
pari^nlhssesK as tr^n IILOGO. Mosi Dl the prrrrnhves which do ndl relurn b value in i ILQQO return ? 
in LLOGO. 

Ttie IChp levtl loop in U^? LOGO h a flKH^0-.KEf4L-f*RJ,Vf loop whereas PDPlJ LOGO is a 
READ'EVAL iccp. This itfean^ Ihat i LLOCO pf-inlL out aniy 4rhtn you «$.K It to p^i^t unNh^ LL0€O 
■whkh pnnb &ut v*luos ^Ifer every eu?lustiO*i 0l a LOGO lOrm, 

InllLOGCfc 

YDU DONT SAY WHAT TO DO WfTH f2 

]n LLOGO: 

13 

Line nur[v'her£ ciin b$ any int^gef MP lo Ihe mftKimgtn rt^jiQiuhjde ^It^wed by 3$ ti^its. Flojillug 
poihit, nflgfllive nurvitwrs ar^d rer& 9fe allewsd al'sfl. Thes* are d<:casi&rially usefut when ySu have 10 
inserl lims betore a line numbered t or belween two Eonsetulively numbered tinea. 

LLOQD fOllowE Ihe LISP conventrons lor numericaj iinpul. In JlLOGOp a ctecirmHl point is an 
►rvdicatoc of flo^limg poin.t Ifiput, sutn H no Iraclional di&ils foll&w tliks FORfPASy} Th& LISP 
£Lor*i/en|ion is that jin inleeei" lolloped by i (.Bfrtim^l pCHn( wilhoul my Ir^diOnjil digit!! ts (Orvsntered 
as 9n intei^er base ten regardless qI Ihe selling of the variable lli/l^K^ which allows Ihe numerical 
input radiK to be thinged. The numher i$ e.anfticle?^ flai^fm^ pomt only A som« rfigil? fallow lh« 
cje-q:itii.fll poirtt. tr» I ILOGOk Jr fs * llojiling pOint number, bul in LLOGH il it *n intepe^^ and IJO is 
floaling point o"ie. .i^.lso, iV is no I used in LLOGO lor negat've expanenl floating point input, is in 
ilLOCM. E witK ■?! P-Sgiiti'/e CKpOr^n] ^oll■0^i^l^g 15 the prof erf cd 1orm. 

In 11 LOGO: 



In LLOOP! 



f^rccr^t &ign i%) does nOl echo as a space, Carnage returns wilhin square -bracketed lhS.ts 
prini out as such, nol as spacer, as in IILOGO- 



EMPry is trie empiy li^l, whifti is LlSP^t Nil. zKMPTYW i« \ha Brrpt/ *Ord, which 'n 1^ 
LtSP atom whose prinE name is </l5CH OJ. 

LLSP LOGO and LILOQO dilfer on the iynitn Igr arrays, LISP LOQO USCS I hit L9SP tnty 

faci-lity: fa d&firte an drc^y u$^p 

/Iffff/lV ^IliJM*-'? r *dlmei»*iiitli 1> . . . -^Jamrnjion W» 

Values can tw stared tj^ 

STORft' ^/jmty nnmf^ <nffhrfripl I' . . ^iH^wript J*^ <wflJ(«* 

V^tue^ are accc^^Eid 55 <l IJip array were a lunclian, whiih estpected- the sarrte number of i-npuls as 
IhE number o-F dimensions in Ihe afray. Arr«y^ £re not eonfiidered iu f^ifl qI y^uf woi-hsp^cc in 
LLOQO, so you cjn't do p-HI^'Tttl-r tlHHflYS, KH/i^K AKH^V^, etc. 

Th» LiOGO *urK-liOn W/l^'WJIt, OF no inpuls, fetuf-ns a random lloaljns point num^beri wtiich 
iis between zero and one. IF given twc arguments, »t returns a f andaiti- number ^)«ie«ri i1s lir-jt dud 
second df g.UFnfr^F, inclitfiivr' il bQlh i1; inpul;; arr- ft^i^ti pOinF, IF relurTi; n tiifcd pOirit numberi 
oth^rwiiES ■! fE turns a fbalirrg pcint nufnber. < RANDOM ti ?> behaves ai IILCCO IT/1JVnC!Af. 

ff(>(/JVJ]0^f'~ in LLi]IQQ tak^& either one Dr two inpglE:. [t given gne inpgl, |he number i^ 
founded loan inleger, ol her wise 4I is rounded lb k many places \o Ihe ri^ht cit Ihe decimal poini a$ 
Specified by (h^ sptond mput. 

Thi TMfE ftJrtttiOn r^lurns r4al titnC in MtOrids, nOl *J!ftw(hE cf ft viMmd, at h LILOGO. 

WCAfr vdi-ijihlfs di-e hjii<hclled diFferfnlly ^n IIQGO lh*ri m 1 DIOQCl n«£4i'dle$^ 4I urtnere a 
LpC/lL ElalemenE is placed in a procedure, Ihe variables declared will be local to the entire 
procedure- this LorrespOnds 16 a fiHOU variable in lL5F^- WCflL accepl; any number dl' vai'iatiie 
names as. input. 

[nEerting lines mtc procedures unrfer pfogram conlrol shotild be done using th» function 
ii\SKRTUm: fn 11 LOGO, the loUowirrg will insert a l-ne mlo RLRTC.fl wTicn MiffifG t^ P^ocuttd^ 

tro .irt'-.vt; 

yla FnfT lil.KTCIf 

TNs will not wiflrl^ in LLOGQ. If«learf replace line 20 wilh: 

>2(i t^'SERTI.lNf• tti PRI\'T [NKW UNK /1DJTKD TO liLKTCfl] 

none ct the IILQQO special commartds whose names beg.Jn with a period are implemented in 
LLOOO, allhQLjtsh IFnc^rt! »rf; oi;cJ!!.ian9lly LISP luhctiohi ^ith dilferent names and semantics which can 
be maiJe 14 do I Fie same \.h\n^. 

There is a memo by WacJe Williams whKh Cifplsins sofrtg pf the i\nsr pornts ol ilLOGO 
synt^ij, and should ist (omsuttKl ^or fuffhef inFormalipn. The L 31,000 User's Manual should alsb be Of 
essistante. 
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LESP LOGO ha^ flow bft*n i iripl*men1ed on UULTIC?, a^d Ihi^ it the onty ver^ifrn ftf LOGO 
available FSr lliat Bytlem. UeiOw ?ro inslruchonj 1<ih uiin^ 11, and » Ii4( of dflferente-s between Ihe 
UUI,T(CS ^fief ITS ver-iiorn;. Encept foF the dif<erenceL m file n-amiirig i cnwpnhon?, flr>d limitstiOr^'S 
imptiB«d by IJia opeT^tjnj syslem, s<iurcfl li'ngusfjn? progrjims ^.h^ulrt fcft ^■hlir'frly tnrrtp atitSe. For mora 
inlormstiofi ofi lulUlTEC? LISP^ ^ee Itie MACLISP Peference Manual by Da-JS MflKSt*. 

■Rie LISP LOCJO muiic pKksge iii avaiUWo !*r njse On K*JLT|CS. St* £*ttiort |fi for mofe 
^(rljtilA, The <Jitp^l4y lUKtl* And GERIv4.AtJ0 packages are not av^il^blB in 1h& MULTECS inpleiTientatiOirv. 
MULTICS does nol have adequalo 'Bcililic^ <0r using, di7.pl ays such as Iht? 3^10 and I he -GTflO. I! 
pr^tabiy wOuld be po^^iblt? to imp^tmrt'iit a rudimtnlar y tu>rNe packigt for 1he ilDra:ge 1yp« di^play^ 
cn PJULTTCS auth as Ihe AflD? and TEKTRONIX lermiiTalSf bul we have nO plar*? t& cfe sO at pte?eFi((r 

iSt Where To Fin J It 

To obtain LISP (jO[^, you mu^l tiril creale a link tt? Ihe rece^^ary tilee. Altrr yoti tof in^ 
type 

Th<^ i^^df. to bt' dofve o<^ly on^e For eaeb uier. Sub^^quenilly, yfiu can gsl LkOGO imply by lyp^A^ 

Y&u should Ihen get a nwssaefl Ifliditating (he verjjun ngmberE nf 1.ISP and LOGO, as on tTS, and th* 
allocator will atk yoit if <!^oyi wan1 Icf use the irnreic b&x. H yeu hswc ti iilc in your direitory named 
§tart up,laJi^^ M wfII b^ read in ni in initialization file. 

]j-2 Fi lg WaiTi i n g Cd n v en I ioils 

At^ [IS Mit fpe^i'kt-Ation c^^ists qI Ewo file names of up to- six chafacler-s ea^H, a di;vlce 
and directory name. A FMe tpecilicatiiSn en MULT3CS i? called ^ "psthn^rr*", dFul coflsi&ti of artnlrariiy 
marty toiTitMiift rtl ft ejith naming a node in a Iree slruclure oH dirsttorie-s and SEgmcrits [file's]. The 
compc>nent5 of a MULflCS paStinamc arij 5ifpnr4Jl*.MJ by ">" eharacler!. Any palhname bejinrinE -wilti 
~>'' \% coniidefed to be a full pathnanfe, ije. ila^t at Ihe rool o< the tree, Olhcf^isp, it is tflfliidered 
Id be relalive lo the directfiry which h cuf/snlly tho dclauH. This. *il| usualty be sflmelhing like 
■^urfd^yaur-projecl-narne^yenur-user-nam*". Fil* namfS »r* Kjutned *^ftO to ha^^e two compOnenls 
as. On ITS ^nd yOy type tliertt into lo LOGO the s-ame way, as I wo ^'ords, except I hat each w&rd 15 nol 
li.mited to siw characleifs. The delaull -SBcOnd Sile rande is 'Oj^o", nol ">", lo be coniistenl with 
MULT3CS c4nv«rvtii«n?. |n yfiiji ditttiar^, Ihe twD lile nHvies w<ll appear ^eparaled by a "". Files 
whoie second names are "Hasr are atsurned 10 c£>^tair^ objC<;t «0dO j^roduced by the I.CSP compiler. 
This wall ce>rri;;sp&hd I0 tbc f<l(& ^ilh only the first name {na secnnd ciOmpAnenl ) in yfiLir directory. 
Here are some eMamplei: [astitMtte your name h 'person* ar>d ydur prajecl: is. "prOfScl^J 

LOGO file n»me MULTlCSi lile nartw 



rfradjlff fifty har ^u.dJ>p¥tiJiti'^pfi'tttn^f6ii.hat' 



rjNid /iJ'^ /iwj ftflj- rjbtiflilfF*" ^Ei.dJ>fip^/f f [>^r'MJt'^IV1iiMhiff^/c0.6ar 

13.3 TefiTi)nj|ggT 

On MIJIT[C:S, <:5tttr<M t:h?r Elders are entered lo Ll^P l>y fii^! NHir^ the finfa* or atin liey [if 
irou h»vp rtnc] an;? l[SP ihould !ype CTHL/, Ihpn fypinj l;h* flrdtn^ry non-ten I rol charicl^r, (h^rn » 
■carriage reluirn. \*JLT[CS ha* rw olher ^ty ol w^nOwlBd'gJng ya*jr eniLtente b*'<?i-e yOu hit « roturn, 
which is the ft^f-Qn for |hl? kludjje: Oefause ci( I hit Ihe c:Drt1fCil-th3rgirle!r Fir* Orienled editor whith 
ei^rtli irt Ihe [TS impl*riflen1al.Dn, docD riol cvisl in Iht UULTJCB iipplementatinnu IMIJl^TJCS u5Ci * Ifl 
rut og| the utcviSSu-s chjrat1«r, and Q to rt»b out the *nSii-e linff. To enler these thataclera lo LLOQO, 
precede them *ith \, 

]( ydv sh&yl<J tisvci to u-:* an IBM 27fll terminal, remfmtjcr Ihst cerlain cttaratters must b4 
ts-caprd, Thp wor-sl ufierideft ire { and ] Hypt ■^■f4tw\i-iigit> eJwji'i Hiftft^ for [ and <r^Bt-xia-n'> 
■^fl-ri^tfifr'-ihrtN* for ]J| type <nr>e-ji>n> F(j' ■'^j ■:f^B(-.ii(rfl> ■^rt^hi!-jij(ji> (or f, KFi^ (yj'j^ rt *:eenr-*i^ji* 
t)e'-Qre? # and «s. Upper snd lower cases a^e diitifijuiihed ^n tAILTlCS, arvd all of ttw system 
function-s, tolh f^ULTlCS's and L LOGO'S, hijve lower case natwa. 

To use LESP LOGO on WULTtCS over 1he ARPANET fw^ir, US, if if rpC'Ofl"t«r*ded tKat Dave 
h430rv's program fUS be used latl^t^r th^ar, TELNElf, See DSKi.tNFCLjTWfe ENFO fm Kwjrt deliil^, 
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SettbHI 13. Us^[^gLLOCO^lnTE^^50andTEWEX systriFHi 



The vfirsJOn of LLOGO fO' TEr<5C runs in i version Cf MACLISP IhaE is- nBjrIy cOmpatibfi 
wSth JhJit US*d *t U|:T-A]. The TfhfiO ueiiion cflr, a^sa be uted On TENEK ^yslBrrre. Mo^l oJ tlh» 
incompatibilities at^ Chaie n^ce^silated by Iha dilFere-rKe in oper^l^ng &ysl(rt>i$. Speci^ifdlLyi th? 
lollowifig ceiwnaf*d?- sre no( impkncnlrd: 

P^/,VrVl(jT IWWKH (Bllai PO/, t/ST Fff^^ 

aiMPfLK 

JSilEOj the special pacKflg^s For LLOGQ <lhft Fui'tl* prlfflttivw, lht fflwit primitivei, and OERM.AI«J are 

Another diflere'nEe beTwean TEN50 LLOGO *ncJ ILOGO on [TS is in the typing OF control 
tharaclcrs <5uch aj /(<;, All, and- ^M Fh& ediling tharaclers - aR aE ttcj. fln ITS Ihc^c 4;hai'*etei"* 
may be lyped a1 any (nms Thcct r.pccilyinE an inltrruut atFion (ftC, a If J wiM aFw-ayi lake sTfptI 
iwmediately. UnForlunaEely^ Ihi^ is iwl Irue in. iho ItJhbd implpmeiTtation, becjuae TEF'EO allows a 
runring prOErvim [43 he- iftterrtip1*£l only by llw chMmter ftC As a resuH Hi ItiiSf il Itie uiti- wanU 
lo inlefrupl Ihe LL^QO sytlcm wFiHa it is- runftinf <t. f;. e«ecul|ina « i^^er defiiwtt functiDn), ha mu?! 
ifir'st type aC. Thi^ will inltrrupt (he p*05i'«i*, *ncl tauw il lo pri^nt ?A, indicating 1tia1 it is waiting to 
^esd 9 eoi+trCk-^hsrMl*!^- The user way Ihen type the desired {dnlrol-ctiaracter, and it will be act«d 
upon. Note thai lyping M:, is ttOI necesisry il Ihc LLOC50 nyftlem is msl rkjcining, bul -rather wailing 
fo^ Fh-ijut, Ther'tlOi'e Itie editing characters may be used wilhDul ditFkully, even O-n Ihc TEFJSO 
Eyslem. 

Anothgr innOr dilfgr*ric« btlweert IN^ \-Mf o^ralmg ay&lerns is i-n the nulatiDn Il3r tile 
nanies. Thrj differefice \i min:irrti2ed by She syntax used by Ibe ILOGO FiIb cflrnrtiJrtda, ftw in5,lBn£e, 
the ccninnaF*d 

w/ill read the File nSKiU^KR; PHOGHH tjt^Q On tTS, wtiita on TEf^O the lile read will be 
DSfC'.PK{K^fiMJ.f:^0[L'SERl Thus maul, user pt^ftrams uill be able to run wilh li^ttte Or no 
modiiicatiCn- to Ih^ir IniK.jt/Q'gtpul operations. 4Note thai the deFaull se^oi^d lile name i? > on |T$^ 
while on TEN50 il is LUO.] U yOu wxnt In u-^ii a LLOCO iniliahzation tile wilh the TEIV5l^ 
implementation, the nfl(t*e ol the f«le shouW be tNfT.IJUO im yOw user directory, 

A version Ot Itl-JbQ LLOGO is currently jvjiHahf* at CaTieeie-MeUnn {CMU-IDBV ]t may be 
loaded! there by mean^ of the Fallowing cuniniandu 
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Thu GERWL/lND pachage is dtftiaheJ li^ provide the uaer with a display envifonment in 
whiCh interesting riDfilf ividl qfucation^ c^n easily be in^eiMg.atpd. wilhoul ihe need ior iophii1i«i»fcri 
tiiSrplny e-quiptrttnt, Th* current imple»nenlBliafi mni on jny *iF Ihe charactef di^pi^ry <9ns&|p& tT> use 
ai tJie A.\. I^boralfiry. 

ConcEptually, GfRKfi.AWD fortsrsis *f 9 square grid, pn wbch mj>' 'live" s& many fs 10 
"germs". EitH germ nwy have an art>Mi*fy lOGO programr a&&£ici«lf!(l wrth rh IKis program 
dp({3rFT*ine5 Ihe g.ei'frt'i rtK>l■pm^7n^s, K well as whelhec it «^|$ ijrty of tjie "fond" pteitht jit iU 
position of Hie sm*- For 3. di^uEsion ot iorrtt &I ths iproblems [Kot can be Inw^^tigjilpd in ||ipt 
enuiron.me^nt, sae LQQO workifig f^apt* 7. 

M.I SlaFTtng Up 

TliB GEPMLAPC package may b* fojdBcf autOnHlicaHy at th^ ?,Urt ef jn LLOOO run. When 
slaTle-d, LLOQO will m>- *>iich tjF the special patka^et yOu w^n| Sfrpply lype YKS, iollQw^d by {i 
tarMaa* rsfurTi^ ■^hen it ,a&ks whelheir ytm wnnl GLRM^AMJ. The GERkfl-AHD park^pp wi^H llien ba 
IftadEtJj and give yog instruttiOnE (flr Jurlher heJp. Wait thai sf (hg gn-d becOmei- garbJed, b&eaLrst ot 
t trartsm.ls5ifln error fnr initaftce, ycu tlh a1 BJi*y lime cause i1 to hs? re-di^playod by typing the 
character a\ [clO*^^l■&l-b^cl!.5^as^^]. 

14.^ TopJeyfl Frimittvei 

Tr^v^kc? pr<tmpl«F. A^ks £)iiesticns nef^atary I9 ggf ^Sarled and olFef^ help, 
CKRMDKMOS 

Runs a series ot -d^mot,, leaving Ihe demD prngrafiii av^llf^ for |tiB u's?r lo p4ay witl^ 

Starts up 9 GERki_AND flK/IfJ-ifeV/l/.'l*flf,NT loop, usinf the grid sal up by Ihe most recent 
call to HVrKVHHM. 

Ewits I run TOFGERtt, hack ta UOCO- 

Escfi prftgrsm defines niw creature. A round cflnsists Ot executing, each p-rtig,ram In i\jtn. 
AHer eaf ■"! roifrt^, (he pr&gr^Tp vails lor inpiil. ]t the user types, a sp^ce, One rcund it performedt if 
Itw u-ser [yp-es a number^ thai wniAy rp^nd^ are ddre. Tliis h repeated indefiriitely until an BrrCr 
ofci^rs, KKPfi/lT i? nol ^ufclle wilh lespect I0 parallel |"'0Cc5^irig, No elForl is made lo try eath 
prfrKraim and see whether an/ tonflieli o^twr, How^verj ewenlually a more elaboral* version cQuld 
be designed Ihet ^as £en±ilivc lo ^ynrhrflnizing Ihe lives o( Ihe g-ermi. If no prOEfams arc parsed 
(p lfF:PK;ir, 4I atternfitfi to Mtt Iho prOgFams assKJaled wilh each gtrr« by Rii'lSt^KHH. 
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H.SCfid rriinttivpj 

]■nl^Hli1^fe4 QERktANO. A square ^ri^ i? crcji?i?d with <niint1u:T> iqiiares in a tide. 
pRISTCftin 

Cledr S'creen ^hd rfdifptf/ ^F^LAND grid. Typmg a\ 93e6 rausfls. this lo huf^pcn, If iKera 
15 a germ on th^ j^Mtre, the chftracler wh*cti reprevenlis Ht^bI germ 1^ prinlffd irv the square's 
position. If l:hE square is v^ 0)ys^^^U^^ an "K" 15 p'ririt*d, ]f Iher* is (qod nn the squiaTe, Itw fiumber 
of partkl«5 i? pi-ihte4. |f the square is emply, a "." is prinlad. 

CH}DP ^paxilittir-" 

A pr&dkate which 6u1puts l^itl Ihe pOvil4h H t \tfi,Hmtl^ Gr^ &quB<re. 
WRAP 

Go inld ^vraparOund" modv,^ If^ <wh\t.h i^trmj tre allowe'd I0 £d across Ihe bO undone? ^F Iha 

grid'. .. • 

mWRAP 

Lvaviq "wr jparburKJ' inode. 

Not* m*l *FW/1P aFwJ .WtFiRrTP affecl l:h* vi!ri.^lfr iWH/ff/iffOVNf). See Page 46. 

Jtfirn't' ^p[JJII[JrtH> 

Ttie germ is rnOyed (6 1Kb specif Ift-J gi'id squai'e. ■^|HJt[[isfl> is j senlerwe &f Ihp k antl y 
t<Kirdin.it(^r; of Ihfr Miuare. Typical' use is; MOVK IWHTIt- \t Ihr £'=''" tnOves to a square which 1^ 
aJready inhabited, THp f&rnisr IrthahiUrti is hilled. MOVK prinis an crr&r mnsiftaae if art altempt is 
madle to MQVE lo b square with an *bs!3i;.lc <in if, (jc a square iwts-ide Ihe ^rtd. The "^pctitisn^ dtoea 
ntfl hflvp ^ICJ bp. adj*£ehll lo the current iocaliCHu Of the £*'"". Hence, Mfll^E allows r^on-bcijl 
wwlvenwnl to any grid ■sciusrfr, 

•<^irrclif>n> ii i^terpreled as a heading. It musi be either 0, ^1?, ]R0 or 270 fmoct 3&0X 
^rf'f iUowi fflore elegance in Ihe descnplifrn of 9 ^*rm progr*rti. if the same structure is used for 
all direction-s, Ihen the pfOgram can ci.»l > sUlspfKedwe whote input is cycled through th« four 
directiOrvs. 

Fn+ t^e specified grid square, th* dat« ttored under the gwer propBrty It Mt lo 



The i-nlocm-alion s toted under |he f|jr'*p*rjy> ii ^tliirncd. Typical uses ar*: 

fC>T50t''/lHl'.' •^p6ittitnt' 'FOCif)} returns lood at <poiitiifm>. 

(CKTSOimaH ■^j^e.^nod* ^.^'IMfl^T^l/VT) rolurns Ihe iMjmbfr+ ^1 ihc gerrn tutrenlly \\v\ng 
ther*, /V/;, if ufidccupiBd. 

<C^TSQU/iHt: '■■ptniti^ny VliSTAU^t;} returns T if I the squtrfl is an obslacle. 

Removes InFornfiation fito^td under ■tpwirtrijX 

Outputs ell q1 fhe intCrmaLiOn ^loredi fcH Ihe £iuen pCKitiom 

Outputs the number oF food p^rficifrs >t the given pDsitiiQn. FOOD rduFTis Of not Nil^ when 
llwre i-s nn iood. . , 

FOObP <ptittiliiitt> 

Predicate whith t«turfi^ numtiBT 6f fond pari in las if my tt Ihs ^ivon potiliont NIL i( nqn*, 
Fffd^FOtW ^it> 

Putt *n> morsels ol fond nn e*ch S(jij*ft of SE'RMLAHD. 
BAT <ni±mki'r> 

Siibtracts <niumfcc^? o1 iood parlicles Prom the current square. Generates an error <f 
<itu:mh*'r> it larger Ihjn Ihe Inlal food inf*il.*fcl(, There are two lypea of gtftm — lh&5e thai are 
hungry and I hose I hat *r* not, Each hufigry %»m >ik a food supply -a^sOcrsted wiilh it. The food 
supply is incifeji^ed <3wery lime he eats bsf Ihat number p1 pprlide^, and decreased ty orse fur each 
gsnaraliOn. If i1 ever reaches f^rs, Ifie germ dies. So, it he eak only one parhcle cl food on a lurrt, 
he mus-t tat agam On Ihe fwkI lurrn if he *jt4 2, Iw can sMp a turn wilhQut estihj, »tt. 

14.5 Multi:ple Cenn PfimitivH 

PelurriB. Ihe coDrdinates q4 |he -sijuaTo Ihat igarm is currently inhibiting, 

NORTH P ^r^r»rm> 

Re turns trgt qnly if the % ci50r*na1e df igerm <is greater than (h« JC coordinate Of the germ 
■whaie program is currentFy twing CKECuled by RKPK/iT. 
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AiiJiii 11^1 f-E. ^'iptrM^ and prints. eulog.y. 
<7i?flW <:jf*rJit> ■'s^unrr-^' 

Tnilia^rze^ ig.e'rin 10 sLarl auk lOcaled al ^tfuotv^L ^srm ie an inlegs^ bstwoBn 1 and ICX 

Relurni the amcwjnl Of fc*d thai Ihs ^rm has. 

True if snd only i-f <rjp!rin> (in jel lo <i^iiflj^> on his neift mgvg, 

H.6 Tunic Pfiinilivca 
IffiADINC ^:jt^.ym> 

Returns 1 he cur rsnt he-sdit^ af the ^Brnt 

Movs ^rtii ttti»^r'> spaices in th« direclifin Oi Ihe curranl hsadini^. Abbr«wia)«$ lo fH 

<itumhrr>. ■^Jltlm^cf? may h« iwgalive. 

BflLK ^nii.mt>*T> 

tMivs ■^Humhf^j'^ spKS? Op-pOtilc l:o the curronl hcjidm^, flt?br<fwi*tes to BK <iiiimA*r>, 
NEXT ^ilittvtiBn^ 

Rl^lUf n& the coafdinaleE nf Ihe next square in Ihe current dire^linn. 

RIGHT <nIllnhe•r^> 

Turn righl cn^mtfir^ dbFgrc«$— ^mniliiF/^ ^hoLiid be a muillipie of 90. This may tie 
abbreviated as RT <tui ttil^i'i'^ . 



Equivafenl 1o RIGHT -^numfcrnr^. Abbreviales k fj <nv.miHir>. 

Retyrris cOOrdiriale& ef the Hniare in from oil |h» lurltB. 
RtGltTSWE f^RS^DK] 

RE^R {RStDE } 

IKFTStDF, \l^tnK\ 

H.? Touch Prhnitives 

TOUCH ^jo*tjlie>ft=" 

Oulpuls ."VC^H if <pfl*(i(ftN> (toes not cOnlaln BOmeHninE Ihat c*n be l-Ouc^wd Olherwisa it 
OutpulB an aliom descriljina ^i^e fogt^ible objml, e.%. BifUBKR ar ORST^iEr TypitBl U5« isi 
IXft/Cff FfiOiVT 

Puts )n obftvcle- At < *q'ui«rir'>. Germs CAFinot ftuve antg $q.ij?rt;!; with ob^lacles. 

14 J CiPlial Var fables 

The rKiJmber q\ 1hp g,8rin whose progf a*?* i& being executed by R^PEATr 

Size Df Ihe QERWLAPJD e?id *et by Ihp CRIt} tunctian. 
:IfVPfGR¥ 

T =^ Germs srp KHted if Ibeir foods-upply gcwL to 0. 
Afft ■> fl ^ertn'E. jflodsupply is ignored by Rf'sPKAT. 
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iWRAPAtiOVSt) 

T "^ MO-tifln atr&ss bfrfdiriS Is ptrmil'lc^l, 

NtL -> UotiCirt ^crcy^i. be^4*f t tt tn ttr^f. 

The user* *iiOu1d nevfrr thjng* Wti/7PA!mJM) ^ftctfy, Uyj ITR/IP J*rt(J |VOIFff>TP fo 

chsnj* modes. 

14.^ Implcincntaiiort ' 

GEftKtflNO uses sn jrray lo repte^cnit fhe grid, ^im! sddiliOnrf ^rr^ys icif e*sy *C4«S$ 1(J 
informal ion about a parlicular ^erin. The tndividuji primitives Bre, 'or the [t^n-st |?arT, 
STraightl&rwardly implemeinlable, givEr* lh#s da1a reprssEnlatien. Sfime care is taken in inter ficmg 
Wi-itti (h»i! -standard LLOGO flrwirflpniprit, so (hjl »|l tho Ususl ■dsbuggmg leptuffts of LLOGO hnjiy l« 
u»ed in the <;lf^ti(?i>ttie«l 5f ^e'rt projt*trt$, (witheut interference -wifh the <lispl*¥ *i Ihe arid. 



Seclipn 15. Dupkf Turtk for ihe 34^^ aaJ CTtii 



The display lurNe package For ItiB 340 and GT^n displays is jIsq usable froifi an ordmary 
LISP ts. bell ii£ Irpm LLOOa &> ^F/lSLOyiW rt.'fin.^ F>lSt- »S^ LliOCOk 



I^.l SlarTtfiji Thf DUpMj 

\t^r\iiil\icf lh(f scris*rm The turti* b <)lspt»yed at Its hon!*, tht centtt el (lie sc^etn. Thj* 
cor"'na'\d is jIe^j uselul^ j-ur restarMng everylhif^ •fhsn Ihings get (fiuled up^ the PDP& loses-, sk. 
iErj^flTDJ^S'Pl./liV 'CTid untrn thr GT40 Jisplay rslhtr lliin l^* 340 dh^play. |f yqu art Mfi^nfi tha 
GT4Q as ai display for the LOGO lurlle, i1 nvsl nOl tuf- l^ggect in t4 TTS a& a cOns^i?. 

Says you want to slop using Che display. Flii»hes lhe display slave. 

It Che display slave (Or Ihs PDP-6 cUbSk chetK Ihat the run light is On. II not, stop, io rc^frt, deposit 
tn 40 snd 4i and Ihtn itart. 

LlSP ti3s IhreB cO^nlrOl characters tOr the displayi 
Turns pff di^pla.^. 



aY 



f\F 



Display prints lil^ fly. 



Turns pn display for turtle^ assuming a prior call IQ ^T/iRTDtSP L/tV . 

IS.a The Turtle 
llfDKnJRTLE [ItT] 

Makes Ihe turtle ifisappear.. 

sifownfRTiK \sn 

Brings the tuirtle back, la life. 
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TIIRTLKSTATK 

Reluirns if \ht, lurlle i& nol diLplayed, tlt^ returns the value c( iTX/fiTTil?. tTVFTt^ is Itw 
nURitavr c4 I he displa/ ilem which tt th* cUrremll turlls. 

jw/iicnjiin.K ■:f^isjs> 

Tlie cwrint turlla i& replacMl hy the filtlurc *Bwn by '^tmic>. Provl^$. •c^ppbility to 
rqt*t« prcEures. Subsequent tMttf* tOmmandi, like FORWARD. RICHT, etc, wiH maKe the picture 
drawn b/ <r*J'4!'> m^ve m it ■! were [lie d^ jgifiri tUfUs (tripngle), 

Rs^r^re-E Ihe ariginil LLOGO ^U»'3'lt. 
|5.3 Moving the Turtl e 

Movet the I urtle <iirpi> M (h* diroctifln i( i& currenlly pointed 

Mows tha lurlle <ui-p»> qppeijt* t* thi diriKlien in which i| \i poinled, 
SRTX <¥> 

Mot^S tlTo turlle 1D {<!:>, yOJR}, 
SETT <^ 

iylf?ut$ tha lurlle l« <XC0f7, <r>}, 

SKTxr <x><y>' 

PJbvea the tyrUt Jfl {^¥->, < j>)i, 
M&ve& lurlla io (JtCOW^^iir^ VOJfili 

Moves iyrtio b (JfCflfi + tJirM'(jfJH4<Jj>V 



Mavei turll'? heme la i1^ Eit^rlirvg sl^lA. 

15.4 Erasln? (be Sere*" 

i fc III ■■■!■ 

WiPE 

Er»KS ihe picture Ofi thfr ^fifeen. Doe^i nCt i^flecl lh§ turtle, pr tny inapis. 

fT/PliCJ.K/lJV [ifC] 

£d]uiv«knl Id ITiPI'; UCJiil^i^. 

15.5 TurnJLLf rhe Tiirtlg 
RIGHT <anel'> [HTl 

Turr**. tlie turlle ctackwise ^CB^J'fi^ degree-s. 
LEFT ^nfl^^ {LT\ 

Turns Iht tufllt tnunler -cloch*iE» ^aniff* de-ftreet. 

SETUE/iD <tintle> 

TlhE turll* is turned lo 9 ha-sdin^ oF ^artf lr>. 

1^.6 ExitTninin^ Ihf Turtle'^ StJt^ 

t*3tt: The turlle's h&mo rs (0, 0> and s he^diria flf cot responds 1* pointing ^U^ifiNt up. The 
vari^iblE!? :XCOR. :TOrJH ar*d jrMOIW describe Ihe si ate &i tlhe furtte in floating poM Th*it 
uafiabtei should nol be ctiin^ed eKpHcillv l>i' Ihe use?. Ttie following fynttlona return compOrienTs 
Ol the turtle'* stalB rounrfptl to the nearest inltEor. 

XCilK 

Oulput? Itit X CQQrdinale of the lurllr. 

YCOR 

OulpuK the V coordinate &f tha lurlle. 
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IIEADffVG 

Oulpyh tho huadirifi of the iurlle. - 

XtWME 

OutjiiTjh th? 'i^ cO&rdinalp Qf the luftlie^ home in ibAtiluhe $<Qfi4 CD9rd>[1a1es {ije. rdatFve id 

(Xltpuk (hfr V rOOrdinjte oT Ihe [urtle''& home nn abaolulift ^ope iMl-dinates. 
I5.V Thr Peti 

Pen lowemi Iq p*p*f . Turlli J»avm a Ir^tt when moved. 

Pun failed trOm fiaper. Turtte does, not iK*<m t track #h«n movod. 
PRNST/ITK 

Rsttjfftg +1 ■■ pgnup or -i - peodown ^ . . _ ■ 

Sits Ih? pen^tale. A connmDn ute fof thi^ j^rlmitivB- ■; to m^ke a stub-procedurs Iran&parenE 
10 per\ staEe. 

T i' po-n i? d&wn, *lsfl W/L 

Outputs (SENTENCE XCfJJ? VCfUfl HEA&iNCl Useful for raflwmheriflg IncaTion via MJIKE 

SETTfmrLR ^Maif> \1jiKfT} 

Sets Ihe ^l^te- el ths turtle 10 <«iti<rri'>. '^ji<i[c> ii a 'sentArK« of ^ c^rdtair^te, V ct^rdmale, 
and hea^lnEi^ Th? hsadirig may be omitted, in which case il 1$ not tiff C4:(cd. 

Di-Etarice from Ihs Ivrlie'i Current localjon to^ <p>. -iii^ it a poini s,pe<iilied b^ * seflient* of 

X and Y coordinatej. 



Outputs abs.*lule dirscliflni ot -^f* irOm tur|1>, 

Outputs relati%'e direction ol <p> IrAm lurlle. 

y,8 Global: Nay igati&B 

Mote: The^t jb^irrtilivei rtt^m floaMpvg point i1 ciith&f ni Iheir iivuU are floating p«ifil. 
RAS'ilK -^K^ <y> 

Outputs -di^tfln^e ol lurlle Irani the point (<f>, <^). 
BF./lRiNG ^i' ^>^ 

Outputs atjsilute dlrEclidn sf 5*i>, ^p) frOm turtle. (SKTti K/fD iREARINC <x> <^^)) 

pOin^^ ttiB tyrrio in th(3 cfirWti*?^ o( t<i>,'iy>). 

Outputs relalive direttian of {^x\ ^y*) irflm lurlte. rfifOJT ^nXF/JRDS -^jt* -tjfSjJ polftts 
I lift turtle in the direction &f {<jrv, <y>>. 

15.9 TrigoinHiietfY 

Cosine a\ <rtJt^J'<f* degrees. 

Sine Ol *anjrJi»'> dBgrBes. 
/iiVlSGKIVT t** *^5^ 

Angle whOs* t*rtgfrtll I* <)r>/<jr>. 
[^1^, COS, ai^d /IT/IN ttt I he forrespDncing Funclinn'S which inpul cjr outpul in radians] 

15-10 Test 

SIfOWTKXT 

Subseau?"! pr-inti'ng i^ m^vcd OA ttie icrecFL [ni1i«l1y, pr^nling begins in 1h« upper l«fl 
corner. 
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S^jb^i^qupnt printing '\* nO longer di^pli^edL texl currenlly On the bcresn repnain^. ' 

An/ \bvI <>n th? s>rre«n is erased and siibse-quBnl prinling is ret displayed. 

A vwithh bhitlj Is T it prlnllnfl h bftlng tljspby«d, JV/f. i1 n(!l. S0I by SJ/tiirr^Xr 
iifDKTEXT, and FfiAirKST. Don'f set it your^ell. 

Viirisbl? cOnlMmng Ihs fiumber oF Ihp display item which is tine lexl displayed by 
SIIOO'TKXr, ett. 

(TYPK <y>> 4£ prated iri ihw Kn'tle's tiitn%n^ tatMiQh, SV-tf "fitk" MARK "^firf" cr^^t^j Ji 
%f\tp of tho w^ird "Iffxl". Th4& 3llc>ws I he wtird lo it>B manipulaled, i.e. Moved to any part of the 
Bcreenn ale. 

Varrables containiTig coDrdinates or texl tc be df splayed on Ihe ureen. Chsng«abl« by mer. 
Initialty TrftM^TJ^f J^O M ^i - 0,, fYKXTYltOMH'- iOQO, Tl^? a^e in atredule Kope ce<jr*r»te6. 

IS.ll MaiilpitJa1iii|C Scenes 

IJc>t*: ;P/CT'L'RJ^ Ks tf»* naeii* ei th» lurlle's Irach. Dco* rrOli iiwlude any snaps displayed vi* StiOtFt 
StimFSN/iP, ek. -.nfRTI.E \a. fhe narrtc ql the tMftle- ,TSXr I* th* fl^m* oi »ny trxt dlsplsyfld ^'t* 
SflOfFTKXT. 

•^»crm\> is moved Ici the curfeni |>D$itiQn pF th« tur^lo and ^i^playe^. [I ij not co^i&d- 

^ifene> is Firdden bul not d^^trpyed. 
PHOTO <«:4TJif?> {SA'/IFS ^ 

TtiB current piclure i-s copied and narned <jckii^. Any old snap pf tbk name is destroyed. 



Ttie picture drawn by ^iint> is n*hp*d fitft\*>. 

TpfCTiJRE ii r^boufid to o freili display item. The itwiol state of ih\% itfrm hkles the tut lit. 
Subsequent comni^nrfs refer to |his mew ilem. 

EMiSN^P 

Ttie orieirt*! :PiCWfiE is. rest-ored, 

'^irj'ni^> i5 made the currcnl pictufe. Iht 6fJy diflerence twlw^en tNi and B (Vff^fri-iV/lF 
<*'rrK*:> is Itiat A new di^piay ilem ii n&t crpjlcd, atiti( tho (urlfe i» npf hiddtn EfVmN/lP iho 
nestorcs 1t^ Driginfll if;(;T"L'lfJ^:. 

Tfne pitlute dra^in by <r|i-mr> 1! ad(fe5d 10 ":jl«H«?>. Ihfr «^iiif:' is eif^cul^lt, r«l0rring to lll« 
tijrile residirte m ■:jiftMii'> Suhtiequcnt cOJnmandL #iil r^i^er E& Ihe aU tuffie, 

iPlCTVRK 1$ thOund (a J new di«pl*^ itein white ti^e tommands are executed. TJib originai 
iPlCTL'RE is rsEt&fHd foliowphg cxeculiOn of line cornm^rvd?. Simifar lo SNAP^ ^iftrwir^ ^rrjimnn rarf*> 
except Ihal na name i? giwen In the n** ilftin InsiJesd, live rtumbor ct Ihe ilerri <!« TBlurned-. Tlius, 
ll^e s^me gffett i-E aeiiieyed byi 

Sfil/IP <iir*in*i> tfisrjfjiiflridi'^ or 

M /I ft' ft' '■■Kitntf PiCWRK ■^■fommti/t^i^ 

evcepl that ^jfen-fl-> is not jdttod to Itie ii^l nf insps, 

A copy uf <^c«>Ne> H rfSspfayed i( |h* turlle^s current pei^ilion. 

Hff>f:SN/IP ^sr^ri*-^ 

AH EDjjiet of tj^n*^> are hidderL 
Ail copies of <if\f.pfi> are dest^'oyed. 
A ii^t corttamirig ali current »n«p4, 
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The pkture ciMrefitly ofl the display screen is jsloHeiJ on a- new ploltor p-jgc f^txyTTEK 
will #?H li jtrray? fr^in prrviQu^ pl>^1 shQuLd b« ^nt^ Jht user -shsuld typ^ ¥E^ if his pr^ce-dirq 
plol is comptete. 

PiAyiTKK i 

Display plotted on current ploltef pBg.e. 
NOPWT 

The platter is released. 
DISPfKE 

Ouliine <?4 7x11 p^ge di^p^jiye-d 3$ ;f^/Ki!£, 

J?-I3 Potj 

Outputs Ihr v^lgi g<f |pal ^<!inr-nuini^rf> i£ a de^ciflial frachDn belween D and I. Carelul; t^ 
nunnbers on Ihe pSl^s ars nurtwd in«c.Ealj bu( LLOQO nOr*m:plty *iip*cts *WiMn»l riMirthert as input. 

Iji^i4 Fgiiitj 

[iP(Hnl& are -diiipbyed whclhet pr rtot tlh« pon i» etcwn] 

DSsplays i point pi Ihs lufUe's tWf*n( l«ation. 

DispUyg a t>«i"( 't <p>, 

Dispfays ^ poinl in *SBisp> at ^ff. 



1515 G^^]^a^ ^tatc ul ihf Turtle'^ IVofld 

For sM 4f tliBse- funclions, the (iril input '''irp!'Ad>' ii oplionsl. JF 1ef| 9Ul, |He ^^mm^nd >'4^^S tp 

RH||4 lUr-tli*'; hOnn« 1$ CUrrfllKt pD^iliOrx 

Jwtnisd lately by mftving Ihe current tPICTL-NH Iq Ihe new hprng, ^Ser/fDJWi? <iKrns> ill SIS J 
res+Ot'es (hp homfr to ihs c enter at the ^CTeen. 

MOTfOH '^K^nm^ 

Mflvfry ^jcrnrv UrvfJcT !hc TijnErol OF jp^rp wjir c*ns.<ile 1. Butlon lermirtste-s moyenienll. 
Thft new t>Oine i? relurived, enprested m absolule s-tate CDordinatti. IF the curf^Hit hiome ia ^^iurt^itd 
immediately srvd Ihe i[>a(t v^r tonMlc i-S «gt»OI-ed, thock Ihst all -Eiwikha? On Ihs cfitor 5cope dalo 
bwikh extervsjion are in the middle .position, 

RI.INK <!ipi"Pii5' 

Blinks <tc<;jt»*> 

Termmdtes blinking, 

R^tLjMns curfrtni bti^hlrtsi* t>t <iin\r\p> » » number fr'ftin 1 (dinnnftit) ta S lbrl£hl«tt]L 
0^di^a^^ly^ :7T;;(?F/.K and jP/tJr^yRK are al manimum brig.htneis. 

BRICfIT <tt:ftHT> <trttrl> 

Sfrt? brPBhinff^s Oi *»&e»^ t6 ^iaiwif*, where *Itvtt* h an inlBfter frftm 1 tft S. 

Returns fgrrgnl sc^lt? fll ^l«nr>, &[*le i* *n inl^aer Irqtn 1 (sttntfar^ St#t«} to fl (]& firwes 
Blandard scale). 

Sets scale Cl <«PBe> l9 ^hiiP, vrhera <«**> ii an "nleger frSm 1 t* J, ^iii«* is a 

myltiplicalive fickle ffulnf. Hence, SCiJLE f doubles the i.i?e al an -Drdin^fy pfeture, ^CALE 3 
quadruples it and HC./ILE 4 "mjlliplies lhg s-lzs by 3 i'Cvlf.li' T res-torus, piclure IS slartdard size. 
ThH£ ia a hardware ^calling, and affecls Ihe current display ai well as Firture display age. 
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The k'^gth qI 9 turtfe step is resel 10 ^*eali'>. <MTrtJn^ m*/ be any r?«l nytribe''. Re-setMrtJ 
Jh* s^ale wilh OS'Cyif.E ralher fham SC^f.F hj^ fhc fidv^nlsge lhal Ihe scale FatlOr may be any real 
nu-mber. However, D^CAHi applies only Ic future display and iX^t t^ turrtnl picture. 



SrctFcm i$. The Husk Bfl?i 



Ths music bdK is b Iqrw gsneratOT for front Ofie td four jimiJIifitoiie VCSicBi, hawmg a range 
Of Nve actavo?. Because fi) the Nrtwaharifig environmBut, iwsic it cowpiled into 4 buffafK and then 
Slii:pped to (he mLrc.r( fton 4ll al Onca, lor smaolh Ultima. Whrrifver possible, these pfimitin'*? hivs 
been macfc cOiripalible v^ith hclh thoLC oi UlOGO snd CLOGO. They ma^^ bv used wilh tha "old" 
(MinsiKy} mutic bos, or 1h<f "ndw" {IhOr^itOfl bosf compiitbie) tnmk box. 

I^] FfW8[j;ii>ji; In 

To plug in the old music hok, find tn EifECUPORf lerrriinsl. Plug i1 ir^to i 300 baud its line,, 
usins (he phono typK |>li4 en !he l5p right of the EKECUPORT back, or th* acouilic coupler, Pulj^Ke 
iurr Ihc! Igrmina! h turrwE* pff, an^ pluR th^ music bflx into the lefl bssth q1 the fJ^tCUF^RT. {Or finrf 
I his ail set ut> m the rnusic roOm on I he Ihifd flwr.> Turn cM the Jnusic box and attjch&d porcu&s^On 
box, and pul 1tie EitECUPO^T switches into the line" and "uppercase" po*Jtions. Turn on the 
lefrnprt^i, type Aif and log ^nlo [TS. The panic procedure lOr Ihe old musit box (uymplflnn Keyboard 
dead but [TS nol ^i&wn'\ is to swilch lo local lowercase tnfuit^ turn otf llw music hox^ and type *.r 
Then type SP, 

Whsn uain^ ths rnusic bdx Iroffl MJLTCCS, rem*-hilher Ihst both carriisgE return and line fcfrd 
must be typed to end' a hne, wh*n utii^ sn E)(tCliFOt?T. The lerminal shqiHd b* in "ha" ciupIeK* and 
"towor case' mddes. The pa^iic prsKC^urs dostrib&d above h nol recotnmendted', sine* pulting Ihe 
lerminal »ni:ci lot?! mdde will have the ef»ec1 of loaeina you ou( 0< MULTJC^. 

Ptyft&iF*^ in the r** rnusic boK is a but inart ai ^ protaieni due to lirni^tatjoni oi prestrit 
hardware, t^e critical item is a nsmall pnec* fll Bifrclronlcs known as the "lerhninal c&ntrcfler card", lo 
be had from Gerner^iP Turtle in the b^sei^enl oF 5^5 Tech S^uar*. Thi? c?ifd is lo be i'^serled in the 
COi-recl Ori^enlalion m port 4 of a Thorfltort bOr, (t' yOu have never dar* this, at.h! PuMmg i| in 
backwards will- biirrt out the csrd.J The music boK should be plEjg;£cd into pOrl 1, 2, oj 3, depervdir^ 
upor^ which ha^ the musSc bcf* card. (II should be labelled-) Ther^ plug Ihe interface conneetOT 'of Ihc 
Thornlon b<3K inlrj- e 300 biud ITS <ine, a termingil mlo pOrl 4, and log into ITS. The f»anic procedure 
lor the re*^' ^nuiirc bci \s. lo ecI your lermir^al lo echo "^Q " (tofttrol-O jpitilL Since Ihe normal 
print routines will aclually teiid '^iLparmat Q> For '^r-sntrot-Q^r^ ihjs jis r*iDst CKily done wilh Itic 
"echo" gadftet of the Thorjilon Qov, a ^rmalJ cOnneclor which makes Ihe ThorlOn Box lOofc. like a full 
<)uple)! compuler line. f]f you want lo make yUurscK ^ne, see General Turtle or Mark k*ll*r; y*u 
probably ^on't n0t4 it.) 

16.^ turning (Jn 

A^sgmiprn yoy jir* plugged ifl and togged i^to ETS, yoti may npw rufl t'Ahi* music box in Lt$f* 
Or LLOOO- LLOGO will Jisk you it you wani th? wuiK bcKE iF so, 11 will asK you w^ich One; if the new 
*h*, it will ash you which port it is ploage^ mto, Mitt answerinjg all cjoestions, lype STAHTMVSiC. 
U ^ill le^i you to turn On the music bdy (the old one wiM mi^^i; a lol of noi«e), and I hen lype OK. 
Thpo, the noise fif any> will stop, and you if* i-eari^ lo s*- 

The niu;iic bO!f c«n *lsp be run ffom a pvte LI$P. Type iFA^WAb MUSfC F/tSL DSK 
LiMUO}, and an-swer Ihe quesliona. Type fSTARTi4li$IO ^nd Ihe FoPlowinE pfinulives will behav« 
tihe LISP SL^RS or F^USRS, (f yOu do ^filfUsrhachpneK tee Mark WilleO 
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A :gT>caf d^fll fli elFftrl has gone into iRsurina yp-wjr^ compatibility wilh CLQCO ar-d 1 1 LOQJ- 
V you have proaraMnt fa+ frithcr &f 1hij5* which nO iSenger work □<* LLOOQi, please let i.n knAi*-, 
rJoJicE that mdtiy^ "irtlerrncdiatp" iimjl l-uncli*n5 fuch a* tWflflU^', wh.ch had b?e" *Titl<jn in LOGO 
cads, nt tupph^d ?? L]5P printt^^Bi lor eJficie'Tuy. [n ddtfatiOn, new f^cililie^ hav« been added 
whiicJi ihSu^d be hePpFtil. En th# foUi^wlrt^, all hkN snlualiOn^ haive been indicated. Occafiionally, 4 
single funclion rsplflces tEveral- LOGO funclJDFiii Ihe others *he s.till mailaiblB, but \r\ay print a 
meii-aEe recarrtwiendir^ tlw nower iuntCfOn for luture cade. Since fflQ^I i»ij4i€ ftftutiorns irt executed 
(Cr elfecl, urle&& olhecwise imliciFcd, Ihe value ol a luncliPni ii Ihe Btom {wo-rd> ?. 

Returnrs thie rtumber whJct^ i:tyrrtf.pQt\4i lo * ^UM btlt. Usii^ ERt/if fe i^^ra ettkienl. Nb 

Takes 1 input, a ll$l 4I duration? Pi^ys (i.e. slores in the music buSfet iof Ihe turrenl 
voice} a tequertt*- of brijsh tioIb^ fBee CJlirtff? End lealt. A duration ai o me*Efef J brunh milflwrd 
Ijy n-l rft&ls. 

ClliWbS ^Mm !>.... 'farm i^ 

T*ki*-s from flne l9 fftur Inputs, which ihotild be (ofwi [■prore^i.ir^s wilh -srgurnifnts, cr 
cfln^tanl^]. CffOKUS evaluates eich iF-^utnenl m lutp, aiMJ then gOes fin to Ihe oext voice, in. cyclic 
ofder, an^ ■I'v.ilijatcs ttio newt argurpenl. EirariKplei 

I 

H 1hc nutuber Of iripuls is the sanw at :M''flJCE5, fieqiffthti;^ C4l|« io CHOfiUS Or SfSvC will 
de I be e^petled Ihingi if the number <?' vOjcc-s used bv Ihe argumenlB i^ equri Id -Nl'dlCES, 
fectjfiiiffr c^'lu *ill also w*rh. Fo«- other ^itualionsi iu£.t remefflbe^ thjul rt'O^CIE r? up^diilcd allc 
ev3lua-tir*E each araument. Foe eirsmple, if ;M'ft/Cf^S «>■ 3 and you CHQRUHi two calls Id Sf^'C, the 
t1«)tt call EC CfirONl/>; will «tFeft v^icc 3, 

VsTsiOn of CfiOfii/S wh«ch lakes enaclly two argiBn^rttj. For upwir-tJ cOmpatibilil/ Only. 
AnalosDus to CHtJfirrS.r 



DRUM <lif* sf^i^l^rn^im^^ 

Ansl^lflue 10 HKVSIt for drum noles <see ftOOM)- 

GRiTCIl 

ftlelurni Ihe flUlnJ5e^' Mf'etflOtfKiii^ fo thB brush tou'-d oi Ihe percussiqn tp^sker, More 
•IfitlSrst 1a USB tiRiJ^tf. 

Takes as input a ns^rte, like (.060 M^KB Gr LlBP SliT. [t muHipSeKet the buffer annj jave'S 
it iB£ thfr "thlhg" o< fhe name. Thai iS| it slore* Ihe tune at <iti», tt oppo^sd 1o protedures. Thi-s 
*l10wi faster playina (iee PJ.flJ^n.WR) ^n<:t rn^y ^t&rsgc <Sj1l'Ed with oth*r LOCO van:al5le*.> Since 
M ^1 If K7'l/i%'(f doc^ r>o1 tlpar fhe bulFec, aiio^i iavmg tn6 fiJiymp lo^rpmcril^lly liTgar portions Of -b 
F6r*E piece. Tufws made on one mufic twjr t*in Iw pigysd On Ihe oSherp with Ihe esceptron thjit tunhH 
wilh exactly Ihr*^ voictjs earn never be played nn Ihe new musit fcni*' (jftt (Vt'OIC^i'S}, W/lKRTl/WK 
dtd nol evisi in CLQCg or IS LOGO- 

IJfl irtpgt^, Cl^pr^ the muiic buf'er, and ttarU at voice I. This jtYOulct b» dOrw iflr example, 
«ltcT typing /^ 1i3 kill an urpleasaflt ±q<^. or alter M/IKftTti'iVi&ng the linal version of a sons, 
bflFOra starting a ntew ont. 

Same a» ffJOfiiV. 

M9^p, Prmlt message lo let you know you tiied! tp U$e l)iis rtik cl Iht pist, 

l^-Op. ?Sto *f«t'f7JVm 
HfRUFPVT 

No-frp. (Sfto Jr/iLf fMI') 

No Irtputs, Pljjrs ttiB muTiic birffer. Dses nSl clear ii. 
MCLK/iR 
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jM p,jv ■v 

Returns Ihe -dwraliofi of (he longesi j^H^Cfc" cf«dted so far (since Iho la±t M Rl/f -C^yJitJ. 

LkeCul lof building prtKt^urss- luch as psrcuiswn accomp-anirrt&nts far w^itr^ry IcnRlh IuhoSl {see 

Takes ont itiput, /tff/. o-r o-thprwiHi, !■ rtttn-NIL, puH mireic in b modt *hefe rtumlaeriria Is 
ffOfti (* 5^,, flivd note 6Ci. is (He same as Fvtte 0. <i.e^ {note mod 60)>, ifl |h^| one n^pd rflt *flrry 

No inpui's. JnfQrm^ jy^trm (h^l yfru i^i^h t* itst (he new irfkisic bojr. Aski which putt music 
boH h plwEiPtJ inli, ^kl^mslly user wHI no-l need Id call NFWMUS^IC, as l;h$ qu«tl5ri«*?ir* st le*d 
tiiTitj 5ijn icff s.. 'Bthei OLDillNSJC. 

NfWUSIC 

Mo- op. liee .WfffJ^Pl.'T'. Thrs fijnftl^h hnj^ t? reinstated ais a way Ic ewcisE Ihe mualc 
patfcag*, for esamplc^ wtiEn &ne wanls [ft la-ad the turtle patkaige in^h^af^. 

Ur^fortunatety, (UtircHJeh no f^^t &f LL0GO>, Itufrc src minor v»rialioF»s belweer^ IILOQG and 
CLOGO. Thft c5i1t*r(jnr.e: b-clwcen PHfVK and SliVC is fins suth problem. AttDr-dirta to Iht MIOGO 
tferrr"? Msriual iVf^Tfi is the bask II LOGO ■ftMitsic -cartiniahd- ]t t.ikr5- twij inputs, a pitch and ^ 
durati-D'H. [1 numbfi^i pi1c1ie& chromatically Itom -£4. tc 3$. with Q being midd>Ei C. There are al^o 
thfefr ipwcisl [jitcticij, a.^ follflw?^ 

-2&, is a rc-sl 

-2i. ia B Qrikh 
-Z5> it ilte^?i. 

IILOGO .^'f>^fi cflrt al&Q take mvHlplfr inp'uts. LLOQO music has implemented all of Ihis for NOTK, 
mc^etpi lh(f mullipl? inpulfi. The numbering is sligtitly dilf«rent I rem CLOGO SfWC, which is 9i^6 
implemenled in I LOGO- Cset! SiNQ}. 

Takes &ne inputs hopefully a number bel*t*ri 3 pfiJ fl, Sets jJVt'0/Cf:S t6 I hat numbs r, 
clears the buff*r, and ^tti il^O^CK tft i. flamember Ihat 3 vcMces is illegal on the new music system, 
arici wilt generate an errAr. II »5 generally better to u±t loui- v4ic.«s, ^n^ blank, iso- Ihal tu^es v\J\ 
play an eilher muaic ban. [n MOffm>&tC T rnodBf (normally nol the case), calling NVOICKS wUh a 
ngmbrr oulsicte Ot [lA] ^iH iwl cause an error, but see^^i tr'i^iy. The 1* ir^put mfrd 4 will be used 
instead. Spring zNVfflCfiS ot If^K^fmE "WOlCtS" cannol be prevented, but is consid^i-ed a fauy 
pas. fttcessirtg :.VfYJ-JC^;3f i; wcl-cOrved. Calls MM/rtlK/Ifl and resets iVOt€E to ]. Set: 



No iripuls. Pul? syslsir. jn mads for old nuilt hot, H>tif\0y inol needed by u&et^ is 
que^tfDnnaire i\ \Qmi lin*^ (uMlce^. Mig^l be wiedy For Bx^mple, il ygu mAde f fisis^t^ke arvsiVe-frrig Iha 
qu)B5T«on5. ■Se*; ^•i■:W MUSIC 

Mp li^i&g>t$, Oulpub IhQ musk buFler, arnd 1h?n does in MA|/FCfHf?^R, Sec: Mtitf^'OVT^ 
MftUfCLK/ifi, M.miVNK. 

Takes &riB inpuS, whwcti muil evaluale Id a Igne (ffjitt^ by ifAKETUNE. It plays 1Ne lipne, 
Does not clesf ar Dlh^r-nrise jlltr ffic cunrtnl music bulFer. Ff.AYrV!^E is Uansp^rervt to lh« 
ejr*»nt number flf vSice-E^ ewn IF Fhe lune gs^s • d^Merent nifmber. ■S*h: JMylKE'ltjiVKn ^Af. 

No inputs. Reluf ns the number d1 tFie nol* which aunpr^ilr's. 'jLiEcncc on Ihw music bo^. {Lihe 
B^WJJf and Cff/Ttff, this ^11 1 win irrdcpcn*rnHy Ot whelher I ] LOQQ or CLOGO pr4niitfvei af« bei-na 
UStrl^ likflwr^e, rt wlH bp IFie -corretl luiriber tor MOIiSH.'SlC T or noirm?! ^late, even lOif diffBrent 
scaleb flies.) Naturally this <hpch.inig 15. ip^s Bifr^ci^n! Ihan just calling StIVC -25. or NOTK -2$. lor IFv 
appropriale duration. 5*e: Sim. WTB, MOfiMUSlCyiSC/lLKJiA&E. 

^to inputs. Like RT/JRTStlJ^tC, t^t^pt t^-fh\yit\ititi »ll sv^lern viirisblss, and run-s 
quest ionnaire a% fAt JiSck 35 Making *h<ch r-iitsic box. Useful in sit ual ions 0I total IcKi aflef p^rtit; 
procedure. Usually tunes c reacted by lfAKIiTiJ\\R,^t-\d u«cr proc^urc? will be intacL Sutler will 
be wi^^d Out, fn rss?; &' peculiar behavior at lagin Dr loBd 1i«ne, ^u^ranleea th^t fver'yb^y t^i>nll4 
they havm 11^ rlevirr yOu thj^nK thsy rte. II Ihis dfles nOl warily b° to "FT.LCE]] NC; |rj". 

Hasit ClOnO sncJ ItOGO niiu^it tflnim^nd. Takes IwO itYputSj a pitch numbEr, and a duration. 
11 is hi'ghly rec&mmended that duraliurrE b* in1*gefi jrealer than 0! Very Urge •durjili&ns Cesich uml 
corresiponds \a a cha*a£tef alorti in LISP) are apl tu ■slow tdown ihe Bystem a lolf so smair rntegers 
»rc h:g,hly sdwi&ed: Pilches are trwn "25. lo 33.y with being middle C. CBut jee tht rem»rk5 iitOul 
J ILOGO's variant^ jVf>F>;, and tha -.flCALKilA^fi and MOllSWiiifC) t^tth -25. is a rssi, -Z^. a toonh 
-23. a firiti^h, -22!, lenar^jcl-. Out isee /TKiJr, fJfJOilfK CfiU'CWJ DuralipnE are normaily broken down 
inlft N-l beals of pikh and 1 beat o' reat, \a as^oid slurrma ''hfi rtiusit. Howipucr, 1I the SPf'Xdf^L 
war^abl* -fJVfiTftVMt-l^r^r^ STACCATi)'\ I beal 61 nOle Foilowtd by N t beats a F rest will be iung- 
fi.e., slc^red in Ihe music bulFer under Itie ciirrent vf^iee). I' other phr.3«iiTg i-s dssired, it t^ay ba 
tdcitd l^tcr. 

Tahe& two inputs, a Mat ol p*khes and a li$t cil <Jurj|»ort¥. C^ls Slt'^fC, pi<iTiri|r pikhefi with 
duratiorks until the jhorlcr list 15 eKhsustc* In etihwr LOQOs, tNs w*s rwl a primitive, but wa& 
iwrittem as a recursive L0E30 pfocedure. 
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ST/lRTMUatC 

No inputs. Should tie cdled tCi Turn Cm I Mb muLic iKiK. \ki\\he CLQCQ^ i1 p^ute-s }u lei yOu 
turn Sn 1Kb b&x, to minimize 1h? ur^jle^anl rwjise geiwrsti^n On 1he old music bOi!. iPKtif'ffKU a'O-ne 
will auffpce)- Q&ars 1h& hnu^pL buM«r dnd sets :l>'i()ICI? !□ 1. Frabably unnecessary wi^h new tf\u^ic 
box. 

VIEN 

Wq Inputs, B»tutn4 dtiration of furffi«f buK#r. Sew: JH P[JFCCi(^JVr, rJH/lf, MJ..EJV. Useful 
when ctiorusing a tune wilh an dccDmpanimenl. If Ihe dccomp^rumenl is the lasl argument !o 
CWORt/S 5in»d wrttjlrts 9 stflp rylif like, 

if VIJ^N =■ Iff, KA' 7"^ PiV STOP 

the atcomipanrhntnt t^^i b& tieed vHHi arbttrarll/ \9i^ lui>«t. 

Sfts '-V01CK to it$ Qne input, provid&d Ihat infEHjt is a pGsillsie imteger leas Ihwi 5. II 
■grf^fer (ti.?n Ihc CUrrcnl numljir'' yf v<>ir'i^;,j .^iVfV^J^'5 i5 C-!)illc:d lO iri^rc^^C ths ninrih*?r. All rrtiJli-t 
Irom now until the nestl call lo l'''rJi'L!l^ {or a pnmilive like ClfriNUS which calls VOlCK'i will g& into 
I his v*ic9. All Ihe voice? im use wiH be imrflipfeKcd pr»er I* f/ififOfiMihg l*ve bufl«f. In 
MOf)l^L>iJitC T m?d? input; f;rE:»tnr th^ 1r dQ npt c^U^e ^rrorj, b^l ^r^ $ittiply cycled ttirniigh Itie 
allowed VQicei. hl^KKm^ <LLQGO> ar Simng {l\%?) A/QiCK \^ not mce. 

l^fJlCKS 

ND"op. Bee iVTMF IVSIC. If anyone has a use lOr this whkh n re»*Oriablfl, B.g.j synOilyhn fcvf 
NVOICBS, wr will be ^ijsd |ci implewnl it, 

^p$cial $y£|$ra variable whi^b ii; user setl^ble- Fts value delemines the behavior ol NitTE 
and SIjVC as above. Current mEarangful mOdas are U'lGAW and UTACC/iTO. AnylhiTift frb* i* 
cOnTPtteTEd Sr/1CC/ira lOT now. 

.MAX 

Th<5 psputki v^ri^We i^ ^ttUdHif a eMI t? if^BfV, sbov^. [I e»rls|$ fflf ctHnpatibifify with 
CLOGOL 

Sipecial sytleiiii variab^^ nOl ID be chB«iiged except by calling jWD^CKS. II tells yOu the: 
niMttber Qf vake± beii^ hited or' i^byed at present. Qelaull is 2. 

;VOfGE 

Sp*<l«l sy$.ttMn v^rlahlr, to br eh^ri^ed CKily by Calling t^OfCE, Tells yQU ll^e current voice 
That is being Nlled. MflUFCi.EAK rebels to I. Always inili^aAized to 1. Can bg changed by c?ll tfl 



SpBtial aysteri variablg which my Iw chjingad by uisr, U Mlf Ihe oflset from rupddle C to 
et irtod in rerjuhiberin^ noleE. 1o ones taste. DbIjjjI! is zero. 

The I LLOGO Fiusic (untliana .tf(/Ctfri^ Ml/TYO, jnd Wti'JT/lJr are not i mpleritenlBti in 
LtXIGa 
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Srctjqii I?. D tip lav Turtk ff-T <tw Knighl TV Term^naU 



]n additi&fi io I he di-iplay lurl'le paLkage lor Ihe S^iJ and GT^qO displays, LLODO also 
pT&vid05 iiCili|i&5 far graphic? Cn ti^t Knight terminals, r^slcf stfli^ lelevis^Ons conlrolle^l Ij/ a PDPl I. 
The->P t<:rminji»s proytde a numbrr of ad^/antaget lor L0I30 ^rapliici over v^tOf-iftWiie refrestad 
CRT's liKe Ihe 3^0. Sirnre tH* pielure which appear* d" a user'i &crsen is stofad in the li's ir-effljryt 
One bit per p&iT,t, ih& user car put up irbiliariiy cO«iiplicatad pKlyr^s conlainring Shy number ftf 
vcr;tDr5, withaul caursing flielutr, [I is possible (o use patterns of poinl? 10 creatt 'shading" BHetts. 
Commands w^hich dei*i more dSretlly wfth tJisptayed im^es, ralhor than through display iisti can be 
itiipltm*nl«d. Prngrawrs tmav tp^l irtdiwWual poirvls beirng ^liiplayed, with^iut necps^ltdting compulBliOn 
o( irvterseclicin cii vcttors. The lurSJe i^ supplied with an "er^^er" irt sddilion to a "pen", A tapabilily 
whitti. 'ivDijId p-rovB ditlituU ifl imptemenit irt a wsttor d-aplay. A split irrprn mode it provided to 
fjKilitaItt iflfefacNon belwaen grjiphic oulpul and character -^ylpiit Irom program typeout and error 

A? ii !he caie wilfi th* clher LLOfSn special p3ck*i«s, Ihe TV lurlle h sw^ilflble at a set d 
L[SP tunclitjris *hit,h tsn be uied ir> an Ordinary ItSP, wilhoul the reirtairvder ot the LOGO 
em/ir<]nrr.enl, Th* TV tiirtte can be OijUained in a tlandard LlSP by ^iQ\ng (F /l^W AtH TVRTLK F/iSL 

The priiniTivei a^/ai1able are des^gnBiJ I* be k tompaSiblB n possible wtEh LLOGO'fi turtlE 
CQiTiinands (or the 340, ?nd \ UOGO^- ■Sonne d^viarvcp from prior ifftplemjnlitbeini of the LOGO turtle 
was nece?s^ry, tiowever, to lake pdvnnnlaiJt cH Ihe unique Foalures. and respect the Irmitdliorre ol the 
device-. Wast of the ipcOnipahljililies are noted in Iha destnplions oF the primilivfr! below. 

^TAHTbiSPLAY ESfl} 

tnlttilizps the icreen. The user ii ^wptied with a single ttrtl*, located at th* ccnttr of the 
screen, witti its pen dflwn and an initial headir-ft ef tern. ^T/lRrBJSP^.^i^ puis tt» user in Spltl 
screen mode. Profiram output appe-nrr- *t the boltom Of the r^tn^n, and pictures drawn by the turtle 
tDrnrnands appear within n displayed box in 1hc upp*r portion nl the M:r«r». Tlie sizes ot bclh tlie 
prcherairt and displBy area are c-h*nseable tiy the ueoFr Tlnj eorrtmand i& als& us«lul at a meant of 
rflinitiajizine *^ rtalartirrg ewerylhirrt -when. thifiES get hspdrn-siy foufled up. ^TJlfiTDt$PL/\Y 
should retlore Ihe entire $ta)e of the lurtla'-E werM lo whal \\ was imtisHy. 

AniDursces the user'j intention to stop using tui-fle priwitives. fifOHtSPiAY Ierininate5 4pH^ 
screen modo, r.D that prmled iutpul [^ay 0«yf in any pari *sf th« ^^^ften. Turtle ccnmianclfi eMBCuted 
.iftft'- a NOD fi^ FLAY will csuie gcftpbc Putput 10 appear, toul ofi assurance is giyen that graphic 
tiu'put and printed Putpul will "Ot interfere wilh e^h Qll*f. WOfSPl/fY ^isO cl*ar£ ihe sctbcti. 
Uie CLBilWSiCflKKJV if you want to return to tplil atreen mode alter CKettiting a NOitS SPLAY r 

SAVKDl^Pf.AY ISVm 

II you exit frPm yOur LLOGO m LtS-P by aZ white ^rawins pictures with the TV turlle, yOU 
will lase the pii^tyre elf awn on the screen, a^ wtH i'^ possibly leave Itift program in an: incflnsictent 
st*tc- Td prevent tatsages Si fhi? lype, the primitive HflVi'-tJlSPLAY can be us^d to esil gracefully 
from Ihe program Mj.lhout losing a piclurc drawn, SAVKOfSPi-AY *ill leave you in OOT, and when 
the LLOQO or LISP is tfinlinu^jdi l;!^ display area *ill be rrdra^n and ewBculiOn Mflttnued IrCtm tli* 
point at whitK H *as interrupted. 



The luT'lff marKflir is displayed *s an isocele-s IrianglGj wilh a line from Ihe cen^fr tQ I ha 
veriex between Ihe equal iidti; 1his line <paint4 in i\tt dir'e^liQn gl 1hc hcatJmg, The tn^ngl? turtlE^ is 
liCff cd in with the displayed picture (ft ^hftw ftr hide the lurtlei poin(t& which are diiplayed when Ihe 
turlle ts. nol over them are turned off, 3f\6 paints wnere nathiii^ a di$p)ty^d are turned dn when Ihe 
tyrli* ■$ ov^r" ihtm. Thi^ pllow? Ih^ (urEHf ^(j fewf mOfe visiblt agiinsl i bath^rouF>d con^istms of ■ 
cflmplex picture, 6r sh-aded area. LLOQCs TV furlle provides an est^a bll of ir^rormalion to Itw uitr 
aboul 11^ tMftk's il|*tfr: Tht ■(*h(et' of Ih* Irl^n^lir indicfllos wh*t 4-kII happen if Ihe turlle is. mSved. 
IF Ihe pen i& down, a filled 'in br>y \z displayed ai the cente:r q1 the t'lAngle^ ]f |1^e 4^*$#r 1'$ down, #n 
OuHimjd bfty appears, 3f KOP mtide is 'n elfatt, ^n 'X" is disp*ayEd at Ihe cenler of the lurtle. [f XQR 
HMde \i no! irt <i<f*el irid bolh tht pen snd the eraser »rc u-p, Only the Iri angle will be displayeid. 
Thit 5tite indicates Ihal the turlle will not draw or er&se lifpes when moved. 

sjffiKnmTKK um 

Mal^je^ Ihe iLrrlle drsa^pear. OflHy lines clrstMrn t>/ tl^ tvrtle will Ht seen, and no m^rKer will 
bv drawn to iridic ate the turtle's position and haadinE- 

^IIOWTVRTLK [ST\ 

Qrir^^ I hie lurtte back to Infe. A tuftle nurkef will be dr^pwn to tncicftt iht t\tl^ oF th* 

turtle, 

A global va<riable which is T if Ihe ilurlle \i being displayed, eke A^JJ.. Dont rtiodily lhi$ 
vannblp yOwrjiell TJ&inR M4KK Ot SftTO. THb ujlue shOuld Only be changgd b/ callc to 
IlfDKTiJHTI.K and SJrflEFTf.'Kn.K. Utitess ejiplieitl^ stated Qtherwiae, Ihe filqljjl variables 
menlianed in this section, sush as rJiCfJK, ■.fiH/if}l\\'€, a-nd -.FKNUTATK^ should no! be directly 
Jtnodilitd by assignment, Use mstpad the tunclnons w^.ichs are provided tOr thai purpose, folate that 
MAKH Ttfill not Ifrt yo^i tnorjity a M'ariable th*t i} tj^e* by Ihe LLOGO System, 

iA AK flTORTfiti <drtiu\-ta.rllir-proi:pdu.rtr* ^t^niMir-lujtlr.-invcf.Jttrtr^ 

Thi-5 allows the user to rubsMlule procedures For drawing Ihe lurlle mariner. Id tie used 
instead ol the ^ystem'^ cteiault tf i«njle turtle. This Feature c/ould be used tci substitute a more iif^lihe 
picture to represerit IFie lurt'e, 10 pnnl stale initOrmatiOn On the screen iprslead oF d^awins a picture, 
Or to record the turfi^'s wanderings. M/iKKTURTLE la^es as tnput the names ol two procedures,, 
ihw iirst to bt e?llefl whenever ihe jy^ttrr^ wunl;^ the tijfFlfr Id *ppe*f, thg EtCPOd lo kns call-ed ^her* 
the sys,leni wanti the turlle ma'hjer la vanish. These procedures will be tailed m z^KK'fi.'RTI.E mode 
when Ihe turtlo'r. st^itc change^,, i.«. by FO^JI'/TflP, fUCUT, PfNmir^\, bIc The prfrredures should 
ev amine Ihe lurtle slate variables, such as XQOR^ lYCON. :!fK/fniNC, :PENST/ITE, etc. lo decide 
how 3rid whpro- the lurffe raflrher 15 Ifl Tjc di^pl^yed The procedures will be ciiccuted with 
-.SKUTtJHTI.E bound to Nlt^ to prevent inl irate recursiouL M lurlle slate variables are rebound 
during th« cKBCutrfln of user sij[>plied lufHe hnai-ker p*oee^re^, SO thai yov t*n d:han.5e thirirt in the 
course of drawing a lurtCe. 

]f therB is n^Ore Ihin one turtle, Mth (urtl* (tn lj< £iven ) separjite set of pfocedures lor 
drawing and erasimg itself. 
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LISP LOCO MEHD Pig, BS Hat*h 4, lfl75 

\^Qi}t\ vaKi^ble ^ronlMnrng Ihe name o( Ihe prQee<iure twing uwd lo draw the curr«ft( tlil-tkn 
Wi, unsarts Ihe Etanddfd ■aysttm Irian-glp lurtfe k in use. &et by MfAKRTURTtii;. 

:mmHnjtfTt.E 

Like rWfiVirfl'ryWT'f.fi', but co-nMirtj protvdure used Id erase the tuftlt. 

The- precEduire used ta dr-j^w the sisndard system lrifing.lle turtle. ]f ySu -wan! lo da 
soinethirvg firet ili£h|ly dilFerenJ than 1he itandji'd lurtto, you mig^t have a pfocedure ta^lirth (l^IIs 
TW/^-J.VCI.Arn/Rrf.K. since TRf/lNCLKTUHTlK dr*vs. the turtle m XQfi rnode, the- siinne procedure 
is ij$«d botti to dFaw ar%d to era;^ Ihe turlle. 

Jl-?Mo>'iii£ the Tun IB 
FdRWAfiff <*tfi^^ lfD\ 

Wowes the turlle <u*pi> in the dtrectiofl A k currently pmnled. 
BACK ^ici-pi' \IIK\ , 

Moves the turlle <itifpi> ovpOsile 16 Ihe direction m *1iieh it ij painted. 

Moves Ihe turde |q i<x\ YGOR). 

Moves Ihe tuflle lo iXCOR, *y*). 

SBtX¥ ^2r> <y> 

Movm the turtle to (^K'^ ^>>J. 

Movpi turtle to (XXOBi-^d*-*, J^mm. 
Moves turtle t5 (XCDR, VtOW -^tfy^X 

Moves turlh to (JLaJH+<((±>, VOONt^Jy^jL 



itOHE {it} 

UovB& Tijrlle fwfflft to ilB sfarlif^fi jiEjilt, ai {0, OJ wr^ » heading af 0. 



ITK/TP 



K4ov**rt«ri| o( 1he tuftlie pa;1 Ihc boundariet qI the- icfe*n by ffP«4r^HB, SEFJ^ K", pfc. i? an 
erroff tinlij^s. WHAF n it^mp. thi-s tauifs m&vement ofl ono edge to Ftjgit in I he turtle** 
rtippearinte at Ihr iSipp[>5ile frdge, js if the screen *as * tflru^. 

Turn^ &Ff wrapat-^^grnj mC-de. ^filFK/lf> rnkes sure IJint thir lurlle's cnor(iiftstps are within 
(he boundarFes o^ the screen. Any ^ubsequenl altempt to move h*y^nd the boundsFiM of Ihw 
KreeiTi will caui^ an frirOr. 

A alcM variable CQrttjinmg f ilF wrapa^OMnd niosfe- it in eHtct^ fXiL olher*ise. 

CuTFtnily, Ihe furlle fll*iys draws weelocs in « prelerrecj direcljOft.; il draws a <ine brlw^en 
two &r*dpciinta the jjmfr way regafdiesi (jf where ihe lurMe iS. Thit It just an ^^ltr<^ncy hack; it^s. m\ 
even noticeable when i:f#»*Fng shod vectofj pr on (hose rare otcssiOns when syste-m load k righ! 
smf the tci-tts Hi drawing rapidly, [i ihis peculiarity |>r(ives annnyit^ to many people, it wild b» 
ehAn5,ifd ts draw al^ty^ in The direclinn qf Ihp turllg's n«o/emen1, 

J 7. 3 EfasJiTIg Ihe Screen 
IF/Pf: 

Ermfrs thB picture □« Ita tentr-, encBpt IhM ■! do«re nOi alfect any IvrlleE which ar« belna 
difplay«d. 

C/.K/lR.^CWKEIV (C5S 

Equivalent to HOHK ^fyK. tfut faster, 

17.^ Tuflliwg the Tmrle 
Kf^lIT <<Ti\gtv^ {RT} 

TuKris tfie turtle dockwif,^ ■^tiftgft^ degrees. 

Turns the tu>'lle counter -clot kwiae '^nn/ftr^ degrees. 



Sbplay TufUr Im- 1he Knight TV Ttrmlrtah ScEtion I?.* 
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SETflEAf) <uttKt^> 

Ths turtle a turned la a heading cf ^nglf^. 

n.h Th* Pwi 

PKMXWN \FD] 

The lurtle^s pm is lowfii^ed. This means thjk iF Ihe turlle is nsOup^J, d lir# will be drjwn 
belwccrt (h"? iufHe'& oW and now pQiiiiofw. A filled m bOif is i;Ji=[iliycd at the CEntcr o1 I he turtta il 
In SltOiFTiJHTl£ mods, lo thow tt*e U55r th»1 Ihe pen -ia dawn. 

Jhs (wn t*. faiced. The lurUa w'ill not draw & line when mov^^d, If SWfllFTlt'RnHE mode is 
cn, th# fillfrd in bM displayed al Ihe center nf Ihc lurlto to indicate FRNDQ^N *iH di'jappear. 

rFf'PiSTm'F. 

A slab b1 variabi* *Weh i* T iCf the pen « down, «lw NIL. 

17.6 The Erjjgr 

A umdvifr lealure of the TV turtle « thfll x. wsH as h*vin)| « "pen" which <r3rt be rai'sed Or 
tow ft red Eo conTrbl drswing ol liftei when Ihe lurtte ii niaved, il also has a-n "eraser". When the 
ersier is dOwrv, ■! the lurtle reSrscPs 9 ime *hith has be*n prEv»cnjs.ly dra^n wilh thp pen do-wfi^ Ihe 
line disappears. This can iilso be Ihaufthl ol as 'dra^inj in 1he same cOlOf Inh as the back^rtjund". 
f+5le iVia^t Ihts means thai il * Une i* drawn wilh ihB *r»srr down, apiy poin.1 lyma on that line wHI be 
lurrved &ff, ^veft (houfth anoLhcr lint ™aht have passed Ihrougl^ the lame poinl. 

Ett/iSUKfMiFN [KRD] " ' 

The eraser «5 lOiWered. When Ihc lurjle tfo-zts^ tines are erastd which were drawn with the 
pen dowr.. Nflle that the pen and Ihe eraser tan"! be down a1 the tame lirr^B, KJ^ASKRfXiWN 
therefore wilt autbmiilicjiMy do a PKNVF, snd P^;.^nCll^^' wJt do an fcK/TS PJ?tVP. An outlined bQ^ i^ 
di^pljlyed »t the center Ol Iho luttie ^vhen in sm}tf'lViiTfS^ (wade as long as ths *F*sef ii fiOwn. 

The eraser is r*iied- 

G!lat>3l vjrt*We which is T ilf th* #rjH*r K dcjwn^ Wf, olherwite. 

Ij.? prawing in XOR Mftde 

En addilion tu drawiofi with the pert down, wtiicli turns ftn poinis tliong the Ime bcinp, drawn^ 
and drjiwrng with Ihe eraser d&wn, whkh Itirns Ofl pOinls *flpna the line being ^r»<ftn, there exislt 
another option, useful In Kftsin tirtumstaneSt. T»*e tUfHe tan ba used 1-0 draw in XOft nwde — 



points ^long thv linr b^in^ drfiwn ^rt; tijrn«d on if thty were previously oFf, and off it they w«rp 
fofPPErJy od. Thi'S [fiodei of opti r itiOf* i« used 1* display Ihc frh^nal^? ItirMo i" SI^Olf'n-'KTl,*; mod*- It 
fllow^ the- same procedure tu draw « line and erase 11, leat/infi whSil was there beltire i1 undislurbed, 

XORDOWN \XD] 

xonup IXV\ 

iXORSTATR 

ikfit\Cf^Qui to the correiportdin^ prjfniti/es for Ihe pen and the eraser. 



17.S ExamminE and MoJif yillg Iti? Turlle't Slalg 

A g.lobj<l v;tri^t?l« conFjilnirig thtf lurll^'^ ^gr^e^iit V. iDcstJan. K CDO-rdinates increase fightwardt 
drul the orrgin is in the center oF IFie screen [bul can be ^h3T*jed vi* Sf^TtiOtif-\ This vjHable is 
always a F^o^ling -pQirit n<unil?c:r. U wripdrOMi^d mode is, in eFfecl, this variabi'e iftdkates dislance tr^m 
i,hir Qrig.in t^ if on an iflli4ni[e plane. El tl» righl edge *f the 5c re-En i? 50C, 3nd SKTX flflft is fion^, 
;XCOR wrl'l be 600.D, buS IFie lurlle will af?pear 4aO umis 10 1Fic kit d (he cri£in. 

;YCOR 

Like r.VC<)fi, bu^ F^ld£ IFie v^iue oF tF>e Y c^rdinale. Y c40r^njl6E incT04$« Upward 

Hold-5 ttic vnlLi*: of \\>t lurlie^a heading, in 1 loafing point. A Fieading Ot zprs cCiTrr-$-fiQ»^fi to 
pciinfing slraigFil upw^^rd, and Fieadir';^ incr^^^'f?? <l^hwi$e. This wirtable always gives Ihe absolute 
hBad-ng, rot rPiJttccd mtKlulci 3tO. AfteF SETflHfin iM. :l!K/it>tW h 400.0, n&t JO.O, ?ltKoyg1i tha 
tur|l« is pointing, ii^ tFw s^me direcFion as .^i^n J il'.^/l/.) 4(^. 

KCOR 

Outputs Ctie X cOdrrfin-alei <5i the Turtle *; tn inUgtf. ]f wrapaound mode is in efiectf this 
function will outpjut t*ie pQiifion of Iha turtle as. 11 appear^, on IFie 5tfeefl, Aitei SUTTi 6it&, XCOR 
would FBturn -TOO. 

I' COR 

Lilt* XCon, bul oulputs iFia Y coordinafe of fhe turfle. 

HEADING 

OufpuTs the hftfl^lir^ q1 Fhe furlle a^ an inlegcr, mjjdulo 360. Alter SET'JiTK/lB *Jff, 
ISt:/IIifNG wculd return. flO. 

niaple^ Tarne far iIk HnigFil TV Terminals SctVmn 17,B 
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IIKHK 

Oulpijtr. fiiE^KNCH 7iC()R YCOR liKAIilNC}. UtfrTuf fcr remiBnibBr^ng, the turtle's ttafe 
vis .tr/lKf: ^TUHTLKSTATK IIKKK A. turtle st^ie E^v«d in thra manner t*n. t>e re-tlQi-frd wsing 

SKTrVRTLK <*i*nr> E^KTT; 

Sfts thff 5.tito oF th* (urMe l(t ^tiatfK '*rEi*'> II ^ iente^ce oi ii tOOrdinste, T cSirdinalB, 
and heading. The- ties^dinj mny b« Omitled^ in which eate i1 ii no! affected. SKTTUHTLK ii Ihe 
irwersQ at KKKK. 

i'73 Multiple Turllfj 

tmijaflly, \h^ \.K(;f is supplied tiy LOGO willi ftne unique lurtle, whkh rehrtemfcef* itt pcni^of^ 
and headinE., and ii fapaljle of d?^*ir*i^ Or erssirrg Una^ when moved. T*ve ab^liiy Iq cre^fli? tny 
nymtwr o1 Ihese crealurei and lo twikh lh# stt*tt|ton o1 the syslem twiween Ihem makes poisitjie 
sych Ehif^s Si ss^igninE ? lurtle kically lo each one o( tevefiri progr*i"!, 

II^fiTCn <lurllf-niimfy 

Creates, a new tutla, christened ^iii rrJi^'-Hi m*>. The turtle treated by HilTCN i\*¥H *ul i*^ 
» 5Eale idcirlicat ta 1^at of the original tuHle p^eiiSrtl sMfrr ? SF/UfrW/SI'l./Jri, It is located al its 
horwe^ at the center ot thu c^nplay area, *h heading pcints sir flight up, iwd ils pem is dowh. The 
newly er-itfltfrd turtle twcOmes Ihe curfeni turlle. arid w^ll rtipanH in ill- turtle cflrnmpcufs, The state 
ol any p^-eviou^ly frealed turlle^ iincluding Ihe ort* crl£inil[y nunplnid "bjf Sr/ifiFOfSPl./lf, remains 
unaflEcted hy if/iTLfl, Qf sny Turtle command referrinE to the new turtl-e. 

USETURTtrK ^^turtf^'-n^tm^■^ l(JT\ 

Selects Ihe named tuptl? !(? te tl^ ttn'^ftht turtle; th+s means that all sdhsequeni lurtle 
commands [FOHf^'mt), nt<;Hf, ... .J, and turtle stale yariables [:HF4fl/W, iKQ&H, jVCOR, . . , .] 

no* Will r«fer tP the SBlecte-d turtle until choneed agun by inothc-f c^ll \cf If^KTUfirLK ui a c^EI to 
it/iTCfi. The stale of 1h^ pt^vK^u^ly jc-lcctcd turUa is preserved so thai il it pft ever ftel*tl*d igiirt, 
lit state will be restftred. The turtte wh^h irS pfOvided initially by STAKTmifPLAV is nanwd 

-.TURTLE 

Global vai'lable wtuch -cPt^tains the rvawe ot the currentty selected tuf'tl*. 
iTlJRTIJ?S 

Global variabl« wWcIl contains a Fist OF the napes oF s4l the lurlles in «yis|«nct. 



fi^i/lKING, R/iyCR, and TXHITitllJ)^ reiyrn irttegeir? il ^H inputs are irtte|<ers, ptherwise 
thwy return ttoatins point numUers- The rtumbCTs rctuifflid are always pOsitiyief and BE/IRliVG and 
TfiWARnS return tiesdrnfri modulO 3tDL 



RASirK ^ientfttt.r. ^f-x-(ia4-y> 

Out^uN the di^l^nc^ Ff-Dm Ihe fur tit lo * pQ<ht ^pir^ifl^d eit>vr by Iwq inp-ul-s which ar^ k 
and y cMrcfinales- rstpetlively, d>" bj^ i i^rtl^nce tti k ^nd y coordinates. 

BKAKtNC --m-ttlfnr.e-nf-x-tfnd-y^ 

Outputs ^hB ab^Qlutfr rJiroctiOn frAm 1ha turtle iu a pnifit s^eelfl^ in » formal Kc«peal7i« te 
nnSGE. (SF.THHm (HKA^INU ■:t> ^j->W poinls I he tur((e m the dirsictien ol C<*=-k-=>*3^ 

T(JW/itinS <in-wrZrrir.r.-of-i-iiB4-y* 

Output? ths relative cfiretliopi frDm the tijP'tlfr (o Ihff pflint ?p*cJliBdL (RtCHT t^TOtF/iHD^ 

'^f> ^j'>JJ points Ihfr tirtle in fho direcSiorv *l i**^^ -^y^l 

I'Jil TrrgqnP'nielrr 
COSfJVt ^ortfJe> 

Co^ir^ et ^Bingle>- degi'ees. 

Sine o! <»n^it> ckfg'&ct, 

Afijle whcwfr t*rt^f!nt IS <s>/''*j-', in degrees. 
t^/iV, Cjr>5, and rlT^IiV ar* the cO"B5 poridnyg ^uncti&ns whith input or culput in TEdiam} 

M/lHtC <Hfxt> 

Similar (o the LLOQO wrumintf TVP^p vnt^pi thai She (ext is printed in Ihe diiptay area, 
beijinnih^ ^t Ihp- turlie^s curprft location. When runniflj the TV turtle from i,l&P, PRiNC is ui«d tq 
prir! I he leift instead of T\'PF. 

l^tSPdiilsandCir^lw 

[Th&s* art displiiyed *ht1h6T or tmli the pan Or (he eraser ts dowrij 



DisTilay Ttirilc lor ihe Knijlit TV Tsmimli Setlinh 17.13 
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Qiif>\9y^ ? D«inl i1 Iht lurlle'^ currien^ l^it^n, 
POtNT <T *w mf> 

TurflS the RQinl a I UKKK m if rt* kipiVt t? ™i Wf^ off rf il is WL 
Pol ST ^ir> ^-r> <7' m- JV!r> 

Turns the point al {^r*', ^j*} Oft flf fl'f aa spefilied tiy ilE- i-np*it. Tht thii^d inp^ut is DptJOrval, 
and rfefiuKs Ifl T [e^g,, lur"rt 1he p^int onj if omiMed. 

Note: Th«&E coiwEnliOn^ ffrf POINT ^Mifr =itiBh1ly Iri&m IhOw usad Im Iht LlOPIk 3^0 turtlB-n 

to accorriinO-dafe I^g ^rspi^bility oF tt^ning a poinl ftit -as *bH ji^ 9a, ' 

Retyrrti 7" or JVJ^^ depending *n whct^«^ tN fpint at the turlle's currBnt lotalion. it oti or 
oM. The IkKlle marher is tiidden ttinpO^srily during (h^ eiteculifin Of POJNTSTATK '*° that display ol 
liie turtle will not interiero wilh \ht; pQirtt beirnB tested. POfNTHfATF. will rfitiFrn wtielher IhB pain! 
betr^E tesled is Or*, ri-^jirdle^s cl hew it was caused 10 3pp^»t -- l?y a line drawn by t^e fur I It, t«H!*t 
pfimtcdf s,hsdi(^, etc. 

POim'ST/iTt? <i> <y> 

Testa the pcinl al ItiB spw^ifl^d (omdlpvalM. 

ARC *rt[fiBij^ "-dfjfff'^f^ 

Draws sn **t pf • circle ol Ihe given Tadius, imd tir|*rtdiirtS ^■!5^ the Si™n number ol de&rees 
irqunet ttit circle cenle^ed &n the turtle'* cui'^ent latation. The arc diawn bcgirtt *t Ihe poini on the 
circle where Ihe turlle's heading n pomtrng, and is drawn in a clOtkwise di'iBCtion \in I he diractiOrt of 
liner Ea&ifig headimg]. 

Circle ^ftniiai^ 

Equivalent Id ARC *ftiiv,f^ !i^&. 

17. 1 4 Scaling 

T-wo func(i&Ti5 ^rt provided Fa* char>ging Iht size -o' the gf a-phii: display? arss si Ih* top of 
the screen and Ihe area F*r typein ?rtd typeouf at the t>ot1om oF Iho scTaern, and Ihe dimension!; oF 
the display *i'e* m tgrtle coordinates. ITSJ/ft' tOrttfOlj Ihe actual size o( Ihe dtSplty area, and 
operates in terFi*s 0( rsisr^T display poihli. Tl^RTi.EiflE is u^td I* psIahMsh Ihe mapping irOm thfr 
tpecifipd H'S/r^ft' into lurlle coordinales -- th* r^virttser* given 1o and returned by the turti* 
primilives. It d&es n*l hjvc ?ny frFl^ft on the visual siza oF Fh* jirpj usied for graphic display pirtpul. 



TVatZK 

Relufns 9 lis! tO^ntami-ng the hari?on|il Wkd Vifrrticjil E^res of 1he diiplpy frt* in ri^ler 
poir»('s. Ttie dE fault 5iize is. 300 it 300. The dnwiensian* n1 Ihe ftftti^e TV screen arw 465 [verlicall h 
S76 thc^fiiZQnl: »l ]. 

Sels bolh the boriiontjil iind verlicri aires □! the display ^re^ |« ^nsto-jfnf*. Modilyifij Ihe 
n^'JJ'ZI': cfku-^e^r, r> Cl.fVUfJfCfffiFiJV to be peffQrTie<l Th(f sfze 01 Ihe a^ej a1 the botJom ol \htf ^crsen 
lor typcip. and typeout it adui^trt-d to- l?*e up 3^ mucJi ip-ace ai pQ^sihtc On. |he screen not being 
u&Ed for ■ftrjphif flutuut. ChansirE the 11^.5/7^ wiil nol hawa any eflecl en pictufes &rBviOus!|y saved 
by «/lKhWl?inOW [se^ 5ecti>0rt l?.i6j 

Sets the horiZQhlal ?ind vertical iizes. ind^perulehtly, jf ejlhef Al 1 he I wo inpijli i^ l^iL^\h^ 

CDrreiponding -size rennmrK urwhafiged. 

Relurni « liaf eontiilning lhe horiionlBl and v^rltt^l sifcs. *f Ihe diipfay area in turtle 
toor-dmslc^. ThB^E are id floalins puml. The 1^ltl?^ def^iull i-s LMO y I MO, and the OKi^irt r? always a1 
lh*e -cenler Qf the- SCffrcn ~ go turtle coordi'-ales initially range IrCru -SdC" 10 +500. U wraparound 
rpode i& in eF<ec1, tyrllfr coordsnales, are sllfiwed above and below (he i-snea- snl by TiJRTf.Ki^lZK, 
Bfld Will b* mjippBd to appropf iaie pa mis on thp streen. 

Se^fi the iJi-mcnji&ns. <5l the tereen in turlle eooKlin*tcs to ^r»>if-fiif^ (urlle s.(ep&. ff the 
diSlilsy arej i? rol square [that ii, il tt^fr henzcinls^ and yeftical TV size para-i^ttrs ire not equal], 
Ihen <nrv}-fit.i'^ i-s taken Id be the nufliber of lurtle jtepfl for thp Fn'nirrHjm dime*iEinri nf 1he £ti"«e-n, 
land (he ottier dimertjion is sdjireled accordinftly. In particular, you cari"! ^per'/ TiJKTLKSTJI^F. 
irvlcpendenlly in eactt directiom, so thtt ^ turlle- step always corre^pondt to 1Iik -..st^ number &f IV 
points. Chianjiins Ti-'HTi.Kmii^-E has r^ eflecl d«i ihe picture turrpntly troing displayec*, or oa any 
picture; saved by MAKKWINntW. 

SKTtiOMH <Ta:af-x-hf>mfr^ *^iwiif-^^ii rti f'-" \Tit\ 

Changes ttw origin o1 lyi-de <iwrdin?tBs ^0 the specified location, defaultina Ifl (ht turtfu's 
pre^nt position, Thai p&sitiion in 1he s-^reen ■*iH then (orrie-gpOnrf to an JtCf^fi andl VCQR of zero lor 
all subsequent tuirllt tOrtimAndi. The home local ion is Incai to eath Igttle, 55 thpi each* OI several 
turtles may be assEgned difltrent hoir^s 4ri the screen. 

17. IS Screen Color 

ThB Kniiglit Itrfflinais have a iatility for «atilv ehjn^irg whelher bils which are on in the TV 
memory will t» d'tp^jiysd Jls dark Or hghl On the user's screen, fly analofty -iwith- Ji photographK in 
"neealive* mode, points whith »he on [g'gohics ard fpxl] will be displayed aa ligJil ofl a da^K 
bacKground. lo "pcreitpive" mode, they are displayed i^ 4mh. 0<n j %^( b3ckg,rOund. The current state 



ffliplajf Tiiifllc fur 11= K [light TV TFrminal-i BccHnti ]7.t5 
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41 # usflr'? tS't'minpl (Wi be tamplemenled by ly^i"! <KSf^> C. Ths foUowmji furiction* jh^Icu* it to be 

T iff the user it in "pOsilive" niodt, iV/ft if in "rvesalive* imidH. 

Puti (tie ustr in neg^frvg morf*, i*- lifiht text Hiyd firws &ti i d*rk IjAekgfcufid. This it Iht 
mode in e'l^ect inrti^l-iy at login tiine. 

COWfiPOSITlVR [CLPi 

Puis tlw usEf ir> posilive Fre^ti d^rk l*Mt dnd pricturei On a light batH^coUfid. 

CiiWHSiftrCti lCtJ:'W\ 

Csmplem^nt-i Ihs COf.f^fiSrjIT'E^ i( 1tie currenl >iiO*? U nftfiative, Hwitchet la pesitivp rtiodftj 
or vicfr versa. This tiai It^e ■sannc dfccl sj lypifig *fi^W> ton itia (a^mmjil, 

[dissaving Pkturgi 

In crealing. picttwe^ ^hitti -e^nsisl ql repealing palEs^'^s oi ^m^Hei" pitlures, asvd crsstirtg 
animaled cartMrvs, 11 is cHen uielul ta be able t& 5?vc flii^pbyed pktures drawn by i Mrie» of 
lurttfr CQntitia'YdSt and oper^le upO" th^m as a unil, displayir»g and pr^sehg th&hrtj (novir-g Itncm to 
Oltier part's ol the atr-een, ek. Ttie LLOGO TV turUe pi-ovides such a faciUlyf sHo^irtg ttie uier 1o 
saws rettipriBiylar portions Of the scresn *$ wiray? of poiimlB. These arrays c*n fee (Hsplayed and 
erased aE amy idcal^Ofi On tli^ screen, altlwugh they cannOl b« iulQmatii^fllly rotaled. 

Ttiis Facilily is sOmcwliflt diHrerent Iffim the SiVnlP cUmmsft^ m the LLOGO 3^0 luTdt tp*ct 
1 1 LOGO. The SN/iP operationi sa^cs I he (slttkwe as display iislsj asBenlialty n vttior representatii&n, 
while I he TV tyrtk Window saves ar, array Ol pfllnts. Foif lafgef sparse pic1ur*5f IH« vector 
repf es^nlalion CDi^sume^ t^r^s 5[J*te, *hitB tlie point arrsy repre^-cnt^tKirt favors ^mal^ c&mpl-eii 
pi-clures, Saving pflinl arrays makes it pOs-sible 10 redisplay pictures rmxh (i*Ort tiflfjidly than 
c*dr»Twirxa Ihem with ibe co*pm?nds w?cdl Iq or-PBinally generatE the picturt^ iinc* recompLita-lion «f 
points lying alOn?. vc^toTS is unoecessary. It is (harefor*? i*>?1 1<3i- pi'Ofirams whieh wsmi Ifl make only 
few, spatially localised char^F^ t-o * picture, twit need the maiti mym pOiSible speed f6r dyn^nilic 
ijpd*tinB oi the streei. ]t also has Ihc advanlas*' J hat the arnounl 6l space and time used for 
crestirrR and r«di*pl^inft pictures is insensirivw to IV tQmp4e:iiV at a piclure wllhln an area. These 
characterislic-5 mak« an ^niiy f«pres*nlation more swtablc Ihan a vetlor Kepfeser>talion for, 5*V, a 
tpuKc -Mfj prosrank, where the space ship mutt b* rediSDlayed rapidly^ snd cOnsuti o1 perhaps a 
ltr:ge number of vetlOis c^rtfincd to << 'Snial' area of the streerv. II alt& prflvidci * "clipping" faciM/. 

Savine poini arrays ha* a property r^t jhJrrd by LLOOOCs R^/IF lOr the 340 -- "Wial you 
Bee is what you gel". Ew^rylhling, *iith«n the desig»^a1ed area is includ^^l, ["eaardlets ef how it w?s 
C*u±ed to appear — veclflrs, lesfl, pflinls, olhff WfNDOWB^ etc. This mearra thut you can always twH 
^hat wil| bv int(lLjded tn a saved picture simply by looking ^1 the screen. 



Crsst^E a Virdow^j Le.f an a*tay a1 (>oi^^t, and nsme-s i1 ^idjtJoTE-ji[im(;>. The <wi¥«ivw- 
flam^^ should be a tford, and should l?t cho'ien so ai noh 1o conflitl wilh (li-islinR lunctiunt ■or 
arrays. The window i^ ccnfcred &n Ihe lurUe'^ cur rem local ion, *nd c^lcnilf lor *tiz*'^ lurEle steps 
honientslly arvj uer1ii:a!ly Ircwt* Ihe cenler. The taciHon of ihe cenEaf of the window und ■)« siSfr pre 
ren^Embered. 

UtAKEiflSlHitf ^^M^\t\'i(^^^■Hlimlf'^ <t\f}rizf}t\al-Mztty ■^■rvrtifsl-fi^ff'^ 

Creales a window cedtered an Iht lurll^-s currenl local ion, twjl sets the hori?on1»l *nd 
verlical sizei oj thr wmrio* in^l^pcndenlly, -sO Ihe area laved can be tettii^ultr" rfls.tp?d cf squa^e^^ 
«S In tK* one input mcnJe. 

Creates a windo* ceritefed pn the ■soecrfictl locslicm, ol IHb spetified size. II Ihe <txnir.iii- 
Micf> I J omitTcd i1 is BEBumed identical lo 1he '■"h*rJis»iJiii-jiij*'>. 

fiR/]5l■:H'/.^'JJ^■>f^ ^u:»irfTDC.-noFnf> i\EfF} 

Oestrayi Ihe wirkJow specified l?y *:pir4f(H(-iiflmp>. |i Ihs window pb no iksnger needed^ thiq 
permils the PS"flce lha>t i1 Occup^Bd Eo be reclaipned. 

^;fl.^5f:[^/.^'D(^Jl^s \f,ws] 

Erflies ai\ ckwreflMy d*lin«| windows, 

Globalt variable which {on)»in& a li^l dI all currently d^rinrd vrindow?, 

TbYas. inpnh like XfAKKWfNdOW, Srcepi for the window raipe. Thai ii, 11 lakes from ore 
lo four inputs specif yina a i.\ie arwJ opiiantlly a etntei' location, WtSiiOWFl^AHii disci ays a hoK Or* 
IHtd screen wliicli indicates Ihe exlenl of Ihe picture which wakrld be S4ved by i M AKEW I NDOiP sl 
|l^ cor r«f!Lp&Titf inf; ^ijc Rnd lOfsliOn. Thi^ is usalul <n deciding tmw laifge a window is nece&Siiiry 
belore using ^!nKt■:\ff^'t)^n^. Tbe box is KOfled into the Mr«fcr*, so that ftivrng tihe 
ir"T.'\'F>fl[ri''H/llffi cammand a^j^Jin will tiiuse the bO* 10 disappear, If nO inpuls are given to 
WiNiXiWyH/IHt-:: the size and lacallan default 1d Ihe lasl D4ves specified 

Causes Ihs specified window lo be displayed at the location at whJoh it wa$ orjglnilly 
created. Current ly^ wraparound is not sSlowrd; disptay- cf thn ptclurB is not allowed 10 cross the edje 
Of the display area. Changing TVSITiE and WliTifi5f?:fi have no itf1«ct Of\ ihts siro tii saved 
pictures. 
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iJ^IIOIFiP'j'iVICK^i?' ^4f-i ri^oiii-iW rfl-*"^ ■^^M-[](>-r(?jiEnr-i> <ir4;iii-4:rnl4'i'' jf> 

C^u^c^ th« windci>v Id be tUi.p\aytd at the new ^acatiiMi ^pscified, 

Atcepis arEumenti liV.e SMfflFfF/.TOOIF. b<\i\ dkphyi fhe window turnrng. oPf any pftJTil 
w/hich was on in Ihe window when A wss crc?l-ed TV effe^-t ai Shii i^ as i-F Ihe pkture were 
redrawn in er^^er nkodt^, V ^ <:4i'l to- SfiOVFWiNTtniF dis-plByed Ihe window On a bisinh #rc4, 9 
is.Hmtit ci*l lo Ifm^JJi'J.VOOtr wHI erase i1. El S^fGn^i^i^•m\F Mjpi^nmpos^d Iht wii^ow on 
&Dn»el:hing EtJrB^dy di:spljyc^, 1hq old picturt 1$ tul ^uarariteed ta remain intact aFler the window is 
hi^fJ^n, 

xoHWi?fooif ... [itri 

Lihe SJf«rrf.V(MJ|f- ?nd HWKWff<>fiOV, but StOR't Itie pitlure into the Bcrean, 
trfjVr;HlF//0*ffe'-:4«in'Jivir-wTJFH'^ Wfl} 

■Cti^ngtS the Pwme locaticm assceiated wilh a window lo Ihe Ep^3ti^ie1!l l(K#tlp", dfUuHing ^^ 
n A'HE. Ttiis h the local ii^n when:! 1hc center of tlie wi-ndDW will be displeyed it only Ihe name Of If^o 
wirvdQw 1$ £iven as irM^ut to K^rfOiFPFI.VIJniT. T{fDt:Wi!</mir, sk, 

S^t'(flF/™0ir5<;JT"f*^> {SITS} 

Creales a file On Ihe dish whiit> 5a¥*s all currerttly ikj'tned windows in binary. They can ba 
reloaded ^t a lal^r (ime with CKTWlfifXiWS- The lile ipeci'lcation Follows the ^anw tOrmai aS olh«r 
LLOGO file iCOmm^ndfi ^utti as RK/iBFlI.E^ and LI^Fs (yfi£;ia the lilename^ are r»ot tv»luat»(t. 

GKrwisnows ^fH'-Mprf.-^ [cirj 

R«1a«d£ windaof^ Iroin a di&h file created by SAVEWl.'^imWS. 

1?.|? Priiitine PIcTiife^ on ihg XCP 

Pictures drawn with Ihe LLDQO TV turtle nsy be priAtsct 0^ Ihe A| Lab'j- Xeros Graphic? 
Pk-mter tc oblain hard c<ipy. The ioHo^ms primitive ■fi'tal^es « (He whicli can be printed by Iha XGP 
control prOgj Jim. SCfi Ik*', 

XtrP ^/'il*'> -^flTM^ 

Cr^^tg^ jf Ilk $*vlfiQ the ippcture in the designated area OF the &cre«n^ Th« (It? t^*^ th«n t^a 
printed on the XGP. The file ■specilicslifln iflil^Mi't the larhe fa'inal as other LLQQO Pile cprnmands^ — 
trQm enift to four WD^di- A 'ectanjulai' area limiting tha picture saved is speti^icd "H tht,' spme- fDrmal 
accepted by the winctow commends -- from One to four p*urnJbei'S, [( omillted', the a-rea delaults to ttie 
Entire screen. Example; 

X*/^ ffCTVUE > see .Hw Jot ' 

3«r^es ^he picture eif tending 'or 100 lurtlie i>\epB hOfizOntalV ^'^ veftit«ll>- lt«ni the |>i;ainl {200^300^ 



in Ihqi Fil-B PICTUPE > on 1he current dRreclory. Captions ctn be printed on Iht serten (jSii^ tht 
MylfiK commflnd and v^ill flpppiSi' fln (he t^rinfed pklur*. The piclure-s will bB approKitnately Ihe samo 
ttE« u jh^y sipposr on Ihir TV screen. CurrcnlV fHclures saved are limited io 300 by 300 TV ptiints. 

Two wsrrwrigs cOncermng >f[iP pictmesi Fifsl, llw XGP tias ia p-roblem cafhrnon to all Xerqw 
machines -- an inability ta r^produLef lar-g.^ blacK T^p,i^n$, An jiU^rnpl; (& print a piclure wilti areas 
fliUffd in bl^cK will csuT-e Itic bIsrN. regions la "wtiile oul". Piclurei crested by tinnj the SII/^OR 
cOrnmand lo stiade rej!,ioni wilti dffnse patlernt will not be priinle-d cori-etlly on (tie XQP, Al'.ft, i1 ii; 
best la Iry tp [itnit ihe a^^^3 ol Itie -screen ^jived lo a? ^[nall an a*rea as possible. Si'nce picture tiles 
musl he Outi^ul 1a Ihe XGP t^ist enough lo insure thai unt knt m ptlnlt^ b^iort Ihc nrv] Of^ '*$■ te^d, 
larp.t f'k's may O'jf.' -^hen the syslem is CT^wdadi. The symptom of Ihis sp^t nt Fussage is blank 
horijanlfll tsndii ui Itn; middlft of the pittyre. More elficient KGP cOmrnands 10 te ifpplemenled sOOn 
witl reduce 1h« lihelitipod of Ihis sprt oF kissage. iniAge± on the TV screen •drawn by tbe TV lU'Hc 
can also be printed Uiirtg the VKtrOniie h*rd cepy machtng, 

17.IS ShadJTTg 

A yiniq/ue a^viinlsae oj (he TV displity* ove? victlor pMei^ted di^jjlays is that ir addition to 
the display oi line drawings, Ihey make le^sible the crealiu^ nt picturo^ IJ$tng shadii'Ci Area}, 
P,ntttrn^ Ol p&inb ot varying di?nsi|ieE Can be u^Z'6 t* 111 I regions, creating Ihe e<Fect of a "^ray 
scale". The TV ttjrlie'iL sh^ading. F^citHy i::; a^rnfi-d taward ci-ealmg ^ conv^nirnl ;tncl cfli^i-cnt mean;; of 
*pe-[;iFyiiiE ar^r-i? lo bp i;ha?Jctl, ?ind pstl^rni to tw u5ed in sh-pdhnR, Thp lja?ic idaa ii thai regions lo 
be shaded are indicaled by drawing a closed curve around them ir> FKNDO^N made, and placing the 

t'l^rtle- inii(J^ Ihe- rSjiiani Ij^forr iiiyiF^p, I he StfAffF/ i:^ni'T\jinii^ with i^n ^rgujngnt delermirung thfl- 

p^tterri to be ijzed. Several siiii>ple pa1 terns are supplied by ttie system^ bul the user has the 
opportunity oF defining new nnti. 

Bhades Ihe area enclosing Ihe turtle's curreiiil location. The input is a paltern ta be used in 
fliadlrtg th» ir■Qi^2 ihd dofaulls to th* SOLID patlo-rh if Orittlcd. The turtle niust be sitling in an 
eftipty area [not Dr> a line ur ^n a tilled in region], at an error results. Tht «1Pe<t of iha primiti^^ if 
to fill in Ihe rBgiiSn surrounding Ihe lurlie'a tOcaliOri with Ihe 5.hading pajlern give'n [by iTiciusive 
Qf?ing tl in with the exi:sting pi^ture]^ The r«gion to- bt shaded mu^t be b-our^ed by a clo£«d cut^e; 
SftADK wfOrkj by Ftlling ill Ihe p?t1[:rr jt^rhnp frijm (he llFtlff's. tOcaMtn, ?nd flopping whffrt * 
bounda-ry is reach«d. U the region is nol closed, the entire screen will be shaded! 

t7M Sliading PaSigrni 

Shading patterns are rep^^stnled »s Fynttiions which tetl the SflADVt pfirtitive how tp 
shada afi area, Ths sys-tem prO^idos a group 0' predef'ncd shading paltsrns, described belOw, thrsB 
will probably tie suFtictent lor most simple us^es of shading^ i-.e. distinguishing a few Tieighboring 
rogiCiri& ^ilh diflareril: shading patlcrnj, etc, Those nircding more sophistical 5d cap*bi|i(ies can dplilfr 
their awn pat1efn&. The predeFmed ^hading patterns currenfiy avaiJattJe are: 

SOLID 

A shad-Jr^ pattern which Fills in every point. This pattern is Ihe defau^l u^ed if n4 argums-ni 
h givvn to Sti/ii)K. 
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A psttffrn whKtl fHfe in frv*ry athtf |wln1, in c.he(;ke*bo*r(J (athigin, 
A pal tarn cftnsisling ef hOriiOnlal lircs, aHprnsitinft liEhT ^ind dark, 
Lih0 Jf OJr//f J/Vf^S, «yE#|>t lii^s »r« v«rk4L 

Bath h&rizOnifak fl«id verfirsl lines, 5Upwriinpfl5Cft 

TKXTURE 

A, p^ltr^rn whic.k lurni; On pOint; r^nfjQn^]^, Cffllrng 1 teirtur« \\^ el Feci. An aiverag.e of h^H 
the poiriti will be lufned on. 

iJGfiTrKxnmH 

Lite TUXTVHK^ bul 5>i?dc tBlng dif'*rtrt( dervsltl(;i ol pciirtfft. li/lRKTKXWRJ^ tuf ns on an 
average of 3/4 of the pointip crealsd by QRIiie two randofm numba^s, UUliTTEXItfHtt ?vrr?f«s 
J/4 Of I tie pfHrtt^K Obl^inpiJ by Aly&ng Nfl I'lftsjlpra HMnJ^r*. 

h|4# sl^nding F>at1«rn$ c^Pi$i$|<ing cil arbilrar^ p^clurea t^n be defined by u&ing I he follDWil^ 
primiiivfi; 

UAKRPATTFRN <ftattfTn-na«n-> <irirtdoU!-iiifl«tr'» ^IJP) 

The fifst argument is -a name lor Che iww pallErm. The ^ecflnd is th* name of H wintk)-*, 
tOn-str IK ted by Ihc- ^AKFWtNfiO^ command, Tlhij cresles a ne^/if pattern, which cwisisls oF the 
picture ^aved in 1he window. The pa I tarn narne rnav then be ;jive-n ars mpul t* SH/^IiF- The- ^Ifecl 
will L.?c^ to fill the clawed cutrve to be £tiac>e^ with 1he picture speciHed= by ihe wlr^lpw. JF artjgi 
beyorid (he exIeTil &f [tie Criginsl picturfl if tfl l?ff shaded, Ihn pitturt u^i:|l Ije repealed twrizontdly 
and veflicalty as man/ times- as is necessary Ic fill Ihe area. 

Alternalively, a shad'ing pattern may be constructed by Ihe user directty a-i a luTcti^ti, [Th<$ 
can result in Fa-slef sbadidE Iharv by using a psiiern c^nslrucled by .IMK^P^TT BiR/V, *fl|hou£li i-fs 
mfrrc dr^FicuH to write, e$p<!<i4lly For (.ampler ipatli^rns.] A patterr> it a iunclion oi two inlegsr 
argunwnls, ^ arid V coordinates &f * word in ttw TV incmory [»s Ifir th* inputs to TV, See Secti-on 
17.22J I! returns an inte^a^i which ip*dic?tes ihe siple of 3? brts o1 Ihg 5cr*pn, IpH JMstlFied. 

17.25 In vi^lblf Mode 

When a program does bolh a cSrisideraljIe Btnflunt &F graphre?- S? wrtl a* non-graphk 
CQtnpvt^ti'On, it atltin L»«LOrnE^ caikveni^nl lo be dble to detRig 1h£se con^ponents separata ly. An 



'TPIVJfeibFfl" modfe makts i\ pfl^^ible lo Jebuj fhe non-grifihii. pa^ts of a ppqi^r-Mi tOnta-irtiFifg turtlt 
commands, lyilheul incurring thi^ Q-^i-hesd Of drawing on the stt-eeiT. When the systetn ■> htivrly 
teaded, code mn in "invisible-" .iHode will run much 1Klief^ allowioa fh* U5cr to run a protedtjre if he 
Is nflt inlcfEstfrd in I he pmluie drawn^ ilhen relgrn |g< "vi.Eitila'' Fnode 1c debue the fuctures drawn by 
Ihs pro^,r3rvi. fh<:rijreE drau^h in invisible inftde are noh sa-si^d jnd returning |« vis-ible made requires 
iha! proerams be i-e-eyofuled lo-c^E&rMifl titt fricturB drawn. 

tNl'fSffiLK. 

Efilers Tnviiihie' motle. Any priraiNv* Ehal wotild e*y*e thanges tu fHcturefi on Ihf sei'tftn; 
mdvemenl ot the hjrtl*^ display of saved pittw*!?, poi'nrs, ek, will ncrt cause ahyUhlni; or* (h? streen 
to chansff ifhils running in inwiiible tiiode. EKecuti^in of procedures wnlaimn^ lurlle pri*niti'/es wSH 
prflccerf much failfi^i tJiiii pcnril-j runnmg of prateduF^i; tonljii-^ing lurlla primitivei (qr the uurpo?* 
of debijgijihj their nOn-graphic behavior. 

VfSSnLK 

PeturnB to "uiiltjlfi-" mpife, TurUg 'unctiofls twve Ihelt u^uM elFecl, as wall si IheJr ursu^ 



I7.n Enivmlma 

Ont pcis.jibi* source of esrtensioiii to I he TV (urn* pickage would lie the Jrt«li^iOtv ct 
pitturt-s^vtr^ tapabililies sim-lar ten Ih^ 5iV/IP cOmmaiM^ ni Ihe LLOGO tu*tHe tot th^r 340, flr to 
llLOQO's 5jV/IP. This (tfcujld diflflir Irom the "wireJows" deieritw<) atOve in Ihal i1 would be a lo^er- 
lesrtl r-*pTO5Fn(atf0n of the picture in terms of vB^lerg lo be drsplayed, ralher Ihjin ^in jirrai^ of 
P'Oinlt. Because the TV icminpSs do nol have hardware for diiplsy O'f vecfftrs, necessitatrng the 
compulation qI p&mt? 'yi"^ akjnj a vecto'^ to draw it, redisplay of a snap *ould be very nearly 99 
tirT*e-c:*n&uming as re-eKetuting the t.0GO p»<icBdura which drew the pit^urt. tn tOntrMU redisplay 
Of 3 window bypflftr^^rt th*t rBcOnnjuTsthin. and requires friuch 1*55 time I0 redisplay I ban the Drigintl 
d^awin^ prrjcedurp required. Ho*ev#r', s vsct&r rDprE-seriJation doei provide ^ev(fral wJyanlagas. Ik 
JL leti sp^tfr-ton^umrnn (flr pi'Juret which oce^py Ijirgc pOrli&ns Of I he screen, thul coflUin few 
veclort. It can be used mofpi 17*51 ly *'ilh pictures far which a sStstrlpliOJii in terms of rectangular 
pcfliortji pi the hereon would tie inconvehieni- for c:^3mplc-, an ir regularly shaped pitlgr*' ni.jr r ftijndjcd 
by drawing? not to be intludnd irt Iho jav^d p^clure. Ttw window i-eprtvcntalion mahps H difficuH to 
as&lEn i ndependif nt njmos lo ttie saved graphic, output Qt (j^h of several programs if the pitfures 
pverlap. Certain rransfornraliona swch *i rotations and scaling might be mor-e easily pcrlOf nied On a 
vecloT representation Ihan o-n pOinT arrays. 

An scfdittoral dilficuHy in providing a in»p fKllily in tha TV turtle similar la I hat pQ^tiblc 
Wilh vector oriented diipUys would arise in implertienti'nE Ihe KR^SK SNAP cftmmanid. ]f several 
lines All p3^5. thrOui;h a single pornl on the i'Jretn, iho poml must irol be turrned off until nil Urcs arft 
erased, [f one lifie is etai*d via gn RHASM SiV/IP, and olhe^ lines slill pti.% through lho pOin^ the 
paint tfi\j$i not bo lurned Off. This requires keeping tr-jtek pi how rrany lirws pass through tsuh poinl. 
Such inforinalion could be Qb(*ine^ irOm cOrnputing the inlersetlion and av^rlsp ol vectors displayed 
whfrrasvor a vector is drawn or eritstd, ot by tupepmg s "refErefVLe count" Iqi- ttch poiril^^ 
increiHented "-ifhsf^vtr n line passing 1hr(iuph the point is d*awn, tltcrsmcntcd when such a line is; 
erased, The "'eraser jnode* of the TV lurlle tijrns nif points alon^ liivs- d'-*wn regardless ol their 
prrwious 5tate. This ma^es ii s-owiewhal les-i convenient thar ER/JSK S.iV/IP lor erasure of one of 
Several Qverlapp<iHiS pjcti^es, allhOueh the same aflecl can be achieved by saving tha previOuB 
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eonlenl^B. ot an area iin 3 v^ndOw before drtwing over it. In some cas.'Eis, ^OH mode c*n t)« g&e-d 
pn&l«^ se that the aame procedure can be used both to draw i pLt^ure, and to erasa it. 

Anott^pF sllernalive r^prgjifnlatioti fo* picture eleimefits would be run lerrgltn cncodpng, This 
■would ruc&rd tti* canteni& of an ares at ttia Etreen, js dOffs thr TV Igrlle "windDw". Eacti line o) the 
area is- Fepretenled as s ^equnm:!? of numbefi. Ttie numben in Itie sequence flitcrn^tply fi|>ecily 
hew m^rry t0rt5*tu1ive pmnts M# oni and how many cOfl^ccutivc p04n|s jr'e q(F. LiKe I tie wir»dow 
o^ratian^ thi-s technique- i? c^^iblc o1 being ufied witti pictures tDntainine -slt^dad fiFCfi^, wtni^li 
wQiUlH flo< he possible vriih a repreBenlaliOri cOi^i^ling Jflldy of v^ftars. AllticMiEhi it would require 
^Qimewhal more? tompglatkCiri tinw (o redisptay than wOuld ? wind^Wf lE woukS ncit cr'ove quite at 
space consuining for larg-c and sparse pietui^es. Tt ii fwt clear whether the lirnc- snd sp^cp tmiieoffi 
ihivotved would pustify the use of \hh reprc-^cr-isri^n. 

Each alternative representalion fOf pklurD clomCrtls ctrrits wUh i| unique advanlages anrf 
dksidv«ri|ae.e&» in terms ol time and spiace efl*cienoy, etse of modification, etc. Raliner Than bBcOmng 
cotimitled to a iing(B TiprfrscnUtion, a better g.oal is to provide tlenisbHity by m^klnR *vailahfe tr-ar-y 
Optaort? and ailowirta * iML&r or an inlelhgenl sytten* lo choosc the repfes^n-titiufi atcaiding, to the 
requirements of the flppN coition. 

An ailernarive r& ttie TV turtle": Approach lo pictures involving shading i$ le exl^id lhe 
LOGO co™r*p1 ol the turtle's ^pen" and ^erKBr^lO a "painl brush", A "painf ctmsiitme dF b particular 
shading pattern ami a width foT tht; paintlsrufih would be thoien by Iha user, When the turtl* is 
mowed after the esfecution of a fiHl'S<ifI!HW^ romrrsind, the shsdinj palter n is drawn in an arpa 
SKTcndine Ion- |hp speLitied width on either side ol lhe path Ol the tyrlli-'s movfiment. How eve r^ this 
meltiod has the disadvan1af,o Ibat prog^jiinis. to $hade even very simple geomeSric tiguTc-s can t^Mflnse 
quite connpliicfttftd. This tnotle mi-ghl be u>selul hdwever, il il w^ro posflibk lo move the "bru^h under 
COrtlrql of Jiome afialfig input -^uch as a light ^t.ft Qt ti'fluse. fliwther possibility is to supply th* 
system with speciiic hncwlcdge aftOut sKadhng tammon shapes, such as circ^e^. 

Other extens-isn^ to th^p TV turtle could center on providing facilities ori«ntpd tawarda 
SinlmatiOn, LO&O as a af aptiics language is primarily oriicnlcd toward the- di^iplay ol sialic picture's.; il 
is weak in sOme Ol I ho capabil'tics ncede-d for convenient general io«5 &f ipovies, A more intensive 
votsbulary pf tran-sformatiDns which can be applied b prtlures would be helpful. Ttiis could include 
rotation jnd ftcalina t>i saved pictures, Ihres dimfntiortjl togrdinMe Iransformalions, as wsil K. ■ 
cpnueriieni way ol incorpOraling user defi^td trains fprmattons. Some iwans d'F eitpticitly control hug 
lhe tinn in wbi^b change;, hjippeii lo |he displayed picture should be provided. ExIer^Siori of the 
conlrol slrijqture to allow parallel execution 01 pr&corftjres would facililate programmiinft 
ind^O«ndenlly charige^ 10 th? pi^lurp which should occur simultaneously, 

Another capability which the syitcm should have is ioit^e provision tOr analog input, iMCh k 
froni n light pcFi, joy«;1ick, labheS, or mouse. TNs would allow lhe syjti^m to obtaiin artd manipulate 
freehand sketctws. Convincing dr&wirs^.5 of people or objects that wou'd be diFlicull lo construct 
from Urrlle programs could tse readily input and Ihon mampLilated by ptcgfanw. Objects On the 
screen could be iselpctcd by a user inleraclively using a ruttjer band vetlOr, which it oHen more 
convenient Ihan lypmg, especially for children, 

lt,22 Implemeiitjtjon 

The PDPil whkh controls the TV terminals mainl^ins the user's screen in its meimOry, Ornf 
bit per pOinT. Ati ITS syaism call allows the 1 Ts memory lo be mapped mlo the address space oF a 
program running on fhe PO*^]0 An- ihitia-lualion routine written in LflP assei^bfy lanEUage performs 
this sys|«m ealt| and sets up an array heador which conymtfts LlSf thai Ihis area 0* memOrif 15 r'e^ly 



ih* fj^t? t<}r a LtSP liwo-ditiwn^ioral inleger ai-rjiy, Thit array is sfCtfs^ible direelly fey Iho u^-er who 
<irds Ihe aLjp-pllurf lurlle primJtive'H nel suilett lo fws needi, All clhsriget ^Q thr El^sp^ay screen ar« 
performtd direcMy by LE?P STOR^Jf, and I he rermnnder 01 Ihe dreplay p^tkaEs re written entirply ir 
LISP. -T- T 

The fflllowing primitives (re probably not of jtrtfral interest, hict jrc- jnterrtal ^0= ^he TV 
turlle packas?, umi mighf concei(/al>ly b« wf us* lo j wer (Jejirirrg nOn&tandarci apptitiliftns. 

Tk ^Hnr> *:i5fllHfflJl-t(iitrrf^ 

This fs. Ihe Array whfth Sqids Ihe user's TV l>uff#r, A call lo TV rttuf nt » 36 bit fijfEci pmni 
ni^mtwr, which torttjiin^i ^wo 16 bit PDPl I ^rds, IffFI juslii.ed. STTOfiP's inlo the array will cauep 
It^ array and the user's screen Ic be modified as desfMbcd ir* the discuES-ion ol t}K/iWMf>DE, 
be\oii. Any suth STOHtVr. sNurfd keep Ihe lo* Qr*rr l&ur bid of each Krord zari. The first iniQvil 
toynts number o( hfir^ Irom Ihe lop, ffom [* ^5"^. The second iselecrs a word on the lidej IpH ro 
righlf from lo- 17 {fUt a lolal ol Ifl. ♦ 3^ - 57E hits ptr line J. 

DN/1IFAff^i.JK ^med*^> 

The PDPll hs% a feature whiifh tnflWes any allempt lo write a word in the II'? memory 
from ih4 POP 10 lo resdt in a spetified boolean luntlion (tw word being wntlpn jnd ths word 
pfcviOLKly theie. OitAWMOtifi changei that spmilicalion according to '^m^itf-', which ^hcHjId be an 
irleeer reprftft^nf.ng, 1he made chosen from ihe values at Dr^e or t^p Iflllowirig alom';:- IQK MOR 
/INDC. S/f.irf:. IIOHP. FQV, $F/W, HKTl, 5KT. For &!< ample, STUEK TV Tri will hyrn (he low 
ordur bit ot the setonri je bit wOrd d1 the TV Mfcr or* if fOR modt is m cHinrt, off if yiiVJM; mcs()t 
is in efJoct, and complem&nl wh-alever 3S Ihere if in Xftff moda. tlftVJrJHOO^ r'tl:Lirr*s the number 
describiris the "iOde previously m «jfeel 

A globirl variable conlaanrng' ihe tvr«nl hrtodfl number aa set bv the iarat call to 
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